String — различия между версиями
Korvin (обсуждение | вклад) м (Новая: Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое ...) |
Korvin (обсуждение | вклад) м |
||
| Строка 1: | Строка 1: | ||
| − | Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками: выделение, поиск и замена подстрок | + | Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок. |
| − | Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. | + | Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием [[регулярных выражений]]. |
'''Родители''': <tt>[[Object]]</tt> <br> | '''Родители''': <tt>[[Object]]</tt> <br> | ||
'''Методы''': <tt> | '''Методы''': <tt> | ||
| − | |||
| − | |||
[[#getc|getc]] | [[#getc|getc]] | ||
[[#get|get]] | [[#get|get]] | ||
| Строка 36: | Строка 34: | ||
[[#dup|dup]] </tt><br> | [[#dup|dup]] </tt><br> | ||
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> <br> | '''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> <br> | ||
| − | '''Реализует операторы''': [[оператор присваивания|присваивания]], [[операторы сравнения|сравнения]] <br> | + | '''Реализует операторы''': |
| + | <tt>[[#оператор +|+]]</tt>, | ||
| + | <tt>[[#оператор +=|+=]]</tt>, | ||
| + | <tt>[[#оператор <<|<<]]</tt>, | ||
| + | [[оператор присваивания|присваивания]], | ||
| + | [[операторы сравнения|сравнения]] <br> | ||
__NOTOC__ | __NOTOC__ | ||
| − | == | + | == оператор + == |
| + | |||
| + | operator + (''строка'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': <tt>string</tt> <br> | ||
| + | |||
| + | Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк. | ||
| + | |||
| + | == оператор += == | ||
| + | |||
| + | operator += (''строка'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра. | ||
| + | |||
| + | == оператор << == | ||
| + | |||
| + | Эквивалент оператора <tt>[[#оператор +|+]]</tt>. | ||
| + | |||
| + | == getc == | ||
| + | |||
| + | getc(''позиция'': <tt>[[string_iterator]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>[[int]]</tt> <br> | ||
| + | |||
| + | Метод возвращает числовой код символа, на который указывает переданный итератор. | ||
| + | |||
| + | == get == | ||
| + | |||
| + | get(''индекс'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>[[int]]</tt> <br> | ||
| + | |||
| + | Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение [[Классы исключений#ERangeError|ERangeError]]. | ||
| + | |||
| + | == setc == | ||
| + | |||
| + | setc(''позиция'': <tt>[[string_iterator]]</tt>, ''новый код'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод устанавливает числовой код символа, на который указывает переданный итератор. | ||
| + | |||
| + | == set == | ||
| + | |||
| + | set(''индекс'': <tt>[[int]]</tt>, ''новый код'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение [[Классы исключений#ERangeError|ERangeError]]. | ||
| + | |||
| + | == at == | ||
| + | |||
| + | set(''индекс'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>[[string_iterator]]</tt> <br> | ||
| + | |||
| + | Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу. | ||
| + | |||
| + | == empty == | ||
| + | |||
| + | '''Возвращает''': [[логическое значение]] <br> | ||
| + | |||
| + | Метод проверяет строку на наличие в ней данных. | ||
| + | |||
| + | == length == | ||
| + | |||
| + | '''Возвращает''': <tt>[[int]]</tt> <br> | ||
| + | |||
| + | Метод возвращает длину строки в символах. | ||
| + | |||
| + | == clear == | ||
| + | |||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Очищает строку от содержимого. После этого строка считается пустой. | ||
| + | |||
| + | == substr == | ||
| + | |||
| + | substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>string</tt> <br> | ||
| + | |||
| + | Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора. | ||
| + | |||
| + | == substr_int == | ||
| + | |||
| + | substr_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>string</tt> <br> | ||
| + | |||
| + | Метод аналогичен методу <tt>[[#substr|substr]]</tt>, только начальная позиция принимается в виде числа. | ||
| + | |||
| + | == copy == | ||
| + | |||
| + | substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>string</tt> <br> | ||
| + | |||
| + | Метод возвращает подстроку исходной строки по указанным позициям. | ||
| + | |||
| + | == copy_int == | ||
| + | |||
| + | copy_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': <tt>string</tt> <br> | ||
| + | |||
| + | Метод аналогичен методу <tt>[[#copy|copy]]</tt>, только позиции принимаются в виде чисел. | ||
| + | |||
| + | == replace == | ||
| + | |||
| + | replace(''начальная позиция'': <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод заменяет подстроку исходной строки на данные, предоставленные пользователем. | ||
| + | |||
| + | == replace_int == | ||
| + | |||
| + | replace(''начальная позиция'': <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод аналогичен методу <tt>[[#replace|replace]]</tt>, только позиция передается в виде числа. | ||
| + | |||
| + | == replace_rel == | ||
| + | |||
| + | == replace_rel_int == | ||
| + | |||
| + | == replace_all == | ||
| + | |||
| + | replace_all(''подстрока поиска'': <tt>string</tt>, ''подстрока замены'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены. | ||
| + | |||
| + | == insert == | ||
| + | |||
| + | insert(''позиция'': <tt>[[string_iterator]]</tt>, ''строка'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод вставляет переданную строку в исходную, в месте, указанном итератором. | ||
| + | |||
| + | == insert_int == | ||
| + | |||
| + | insert(''позиция'': <tt>[[int]]</tt>, ''строка'': <tt>string</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | То же, что и метод <tt>[[#insert|insert]]</tt>, только позиция передается числом. | ||
| + | |||
| + | == erase == | ||
| + | |||
| + | erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | Метод вырезает из исходной строки соответствующую подстроку. | ||
| + | |||
| + | == erase == | ||
| + | |||
| + | erase(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) <br> | ||
| + | '''Возвращает''': текущий объект <br> | ||
| + | |||
| + | То же, что и метод <tt>[[#erase|erase]]</tt>, только позиции передаются числами. | ||
| + | |||
| + | == find == | ||
| + | |||
| + | find(''подстрока поиска'': <tt>string</tt> [, ''начальная позиция'': <tt>[[string_iterator]]</tt>]) <br> | ||
| + | '''Возвращает''': <tt>[[string_iterator]]</tt> <br> | ||
| + | |||
| + | Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию. | ||
| + | |||
| + | == find_first_of == | ||
| + | |||
| + | == find_first_not_of == | ||
| + | |||
| + | == begin == | ||
| + | |||
| + | '''Возвращает''': <tt>[[string_iterator]]</tt> <br> | ||
| + | |||
| + | Метод возвращает указатель на начало строки. | ||
| + | |||
| + | == end == | ||
| + | |||
| + | '''Возвращает''': <tt>[[string_iterator]]</tt> <br> | ||
| + | |||
| + | Метод возвращает указатель на конец строки. | ||
| + | |||
| + | == dup == | ||
| + | |||
| + | '''Возвращает''': <tt>[[string]]</tt> <br> | ||
| + | |||
| + | Метод возвращает копию строки. | ||
Версия 13:13, 17 апреля 2008
Класс string используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок.
Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, библиотека языка K++ вводит операторы [] и []= для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием регулярных выражений.
Родители: Object
Методы:
getc
get
setc
set
at
empty
length
clear
substr
substr_int
copy
copy_int
replace
replace_int
replace_rel
replace_rel_int
replace_all
insert
insert_int
erase
erase_int
find
find_first_of
find_first_not_of
begin
end
dup
Приводится к типам: int real uid bytea
Реализует операторы:
+,
+=,
<<,
присваивания,
сравнения
оператор +
operator + (строка: string)
Возвращает: string
Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк.
оператор +=
operator += (строка: string)
Возвращает: текущий объект
Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра.
оператор <<
Эквивалент оператора +.
getc
getc(позиция: string_iterator)
Возвращает: int
Метод возвращает числовой код символа, на который указывает переданный итератор.
get
get(индекс: int)
Возвращает: int
Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение ERangeError.
setc
setc(позиция: string_iterator, новый код: int)
Возвращает: текущий объект
Метод устанавливает числовой код символа, на который указывает переданный итератор.
set
set(индекс: int, новый код: int)
Возвращает: текущий объект
Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение ERangeError.
at
set(индекс: int)
Возвращает: string_iterator
Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу.
empty
Возвращает: логическое значение
Метод проверяет строку на наличие в ней данных.
length
Возвращает: int
Метод возвращает длину строки в символах.
clear
Возвращает: текущий объект
Очищает строку от содержимого. После этого строка считается пустой.
substr
substr(начальная позиция: string_iterator, количество символов: int)
Возвращает: string
Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора.
substr_int
substr_int(начальная позиция: int, количество символов: int)
Возвращает: string
Метод аналогичен методу substr, только начальная позиция принимается в виде числа.
copy
substr(начальная позиция: string_iterator, конечная позиция: string_iterator)
Возвращает: string
Метод возвращает подстроку исходной строки по указанным позициям.
copy_int
copy_int(начальная позиция: int, конечная позиция: int)
Возвращает: string
Метод аналогичен методу copy, только позиции принимаются в виде чисел.
replace
replace(начальная позиция: string_iterator, количество символов: int, строка замены: string)
Возвращает: текущий объект
Метод заменяет подстроку исходной строки на данные, предоставленные пользователем.
replace_int
replace(начальная позиция: int, количество символов: int, строка замены: string)
Возвращает: текущий объект
Метод аналогичен методу replace, только позиция передается в виде числа.
replace_rel
replace_rel_int
replace_all
replace_all(подстрока поиска: string, подстрока замены: string)
Возвращает: текущий объект
Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены.
insert
insert(позиция: string_iterator, строка: string)
Возвращает: текущий объект
Метод вставляет переданную строку в исходную, в месте, указанном итератором.
insert_int
insert(позиция: int, строка: string)
Возвращает: текущий объект
То же, что и метод insert, только позиция передается числом.
erase
erase(начальная позиция: string_iterator, конечная позиция: string_iterator)
Возвращает: текущий объект
Метод вырезает из исходной строки соответствующую подстроку.
erase
erase(начальная позиция: int, конечная позиция: int)
Возвращает: текущий объект
То же, что и метод erase, только позиции передаются числами.
find
find(подстрока поиска: string [, начальная позиция: string_iterator])
Возвращает: string_iterator
Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию.
find_first_of
find_first_not_of
begin
Возвращает: string_iterator
Метод возвращает указатель на начало строки.
end
Возвращает: string_iterator
Метод возвращает указатель на конец строки.
dup
Возвращает: string
Метод возвращает копию строки.
