Deeptown Manual - Вклад участника [ru]

String

2009-06-12T16:14:09Z

Humbug: /* substr_int */

Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок. Важно отметить, что все строки хранятся и обрабатываются в кодировке '''UTF-8'''. Например, метод <tt>[[#length|length]]</tt> для этого класса, возвращает длинну строки в символах, а не в байтах. Таким образом, реальный размер строки, содержащей многобайтные символы, не будет совпадать с ее длиной. При необходимости работы со строками как с потоком байтов, следует использовать класс <tt>[[bytea]]</tt>.

Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием [[регулярных выражений]].

'''Родители''': <tt>[[Object]]</tt> 
'''Методы''': <tt>
[[#getc|getc]]
[[#get|get]]
[[#setc|setc]]
[[#set|set]]
[[#at|at]]
[[#empty|empty]]
[[#length|length]]
[[#clear|clear]]
[[#substr|substr]]
[[#substr_int|substr_int]]
[[#copy|copy]]
[[#copy_int|copy_int]]
[[#replace|replace]]
[[#replace_int|replace_int]]
[[#replace_rel_|replace_rel]]
[[#replace_rel_int|replace_rel_int]]
[[#replace_all|replace_all]]
[[#insert|insert]]
[[#insert_int|insert_int]]
[[#erase|erase]]
[[#erase_int|erase_int]]
[[#find|find]]
[[#find_first_of|find_first_of]]
[[#find_first_not_of|find_first_not_of]]
[[#begin|begin]]
[[#end|end]]</tt> 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> 
'''Реализует операторы''':
<tt>[[#оператор +|+]]</tt>,
<tt>[[#оператор +=|+=]]</tt>,
<tt>[[#оператор <<|<<]]</tt>,
[[оператор присваивания|присваивания]],
[[операторы сравнения|сравнения]] 

__NOTOC__

== оператор + ==

operator + (''строка'': <tt>string</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк.

== оператор += ==

operator += (''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра.

== оператор << ==

Эквивалент оператора <tt>[[#оператор +|+]]</tt>.

== getc ==

getc(''позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, на который указывает переданный итератор.

== get ==

get(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

<source lang="kpp" line="1">
export function void main() {
for(var int count=0;count<10; count++) {
print("0123456789".get(count));
print(" ");
}
}
</source>
Вернет: 48 49 50 51 52 53 54 55 56 57

== setc ==

setc(''позиция'': <tt>[[string_iterator]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, на который указывает переданный итератор.

== set ==

set(''индекс'': <tt>[[int]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== at ==

set(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу.

== empty ==

'''Возвращает''': [[логическое значение]] 

Метод проверяет строку на наличие в ней данных.

== length ==

'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает длину строки в символах.

== clear ==

'''Возвращает''': текущий объект 

Очищает строку от содержимого. После этого строка считается пустой.

== substr ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора.

== substr_int ==

substr_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#substr|substr]]</tt>, только начальная позиция принимается в виде числа.

<source lang="kpp" line="1">
export function void main() {
var string word = "Hello";
for(var int i=0;i<word.length(); i++) {
puts(word.substr_int(i,1));
}
}
</source>

Вернет:
;H
;e
;l
;l
;o

<source lang="kpp" line="1">
export function void main() {
puts("Hello_world!".substr_int(6,6));
}
</source>
Вернет:
world!

== copy ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает подстроку исходной строки по указанным позициям.

== copy_int ==

copy_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#copy|copy]]</tt>, только позиции принимаются в виде чисел.

== replace ==

replace(''начальная позиция'': <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод заменяет подстроку исходной строки на данные, предоставленные пользователем.

== replace_int ==

replace(''начальная позиция'': <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод аналогичен методу <tt>[[#replace|replace]]</tt>, только позиция передается в виде числа.

== replace_rel ==

== replace_rel_int ==

== replace_all ==

replace_all(''подстрока поиска'': <tt>string</tt>, ''подстрока замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены.

== insert ==

insert(''позиция'': <tt>[[string_iterator]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод вставляет переданную строку в исходную, в месте, указанном итератором.

== insert_int ==

insert(''позиция'': <tt>[[int]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#insert|insert]]</tt>, только позиция передается числом.

== erase ==

erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': текущий объект 

Метод вырезает из исходной строки соответствующую подстроку.

== erase_int ==

erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#erase|erase]]</tt>, только позиция передается числом.

== find ==

find(''подстрока поиска'': <tt>string</tt>, ''начальная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию.

== find_first_of ==

== find_first_not_of ==

== begin ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на начало строки.

== end ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на конец строки.

'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.

String

2009-06-12T16:13:19Z

Humbug: /* get */

String

2009-06-12T16:03:49Z

Humbug: /* substr_int */

Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок. Важно отметить, что все строки хранятся и обрабатываются в кодировке '''UTF-8'''. Например, метод <tt>[[#length|length]]</tt> для этого класса, возвращает длинну строки в символах, а не в байтах. Таким образом, реальный размер строки, содержащей многобайтные символы, не будет совпадать с ее длиной. При необходимости работы со строками как с потоком байтов, следует использовать класс <tt>[[bytea]]</tt>.

Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием [[регулярных выражений]].

'''Родители''': <tt>[[Object]]</tt> 
'''Методы''': <tt>
[[#getc|getc]]
[[#get|get]]
[[#setc|setc]]
[[#set|set]]
[[#at|at]]
[[#empty|empty]]
[[#length|length]]
[[#clear|clear]]
[[#substr|substr]]
[[#substr_int|substr_int]]
[[#copy|copy]]
[[#copy_int|copy_int]]
[[#replace|replace]]
[[#replace_int|replace_int]]
[[#replace_rel_|replace_rel]]
[[#replace_rel_int|replace_rel_int]]
[[#replace_all|replace_all]]
[[#insert|insert]]
[[#insert_int|insert_int]]
[[#erase|erase]]
[[#erase_int|erase_int]]
[[#find|find]]
[[#find_first_of|find_first_of]]
[[#find_first_not_of|find_first_not_of]]
[[#begin|begin]]
[[#end|end]]</tt> 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> 
'''Реализует операторы''':
<tt>[[#оператор +|+]]</tt>,
<tt>[[#оператор +=|+=]]</tt>,
<tt>[[#оператор <<|<<]]</tt>,
[[оператор присваивания|присваивания]],
[[операторы сравнения|сравнения]] 

__NOTOC__

== оператор + ==

operator + (''строка'': <tt>string</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк.

== оператор += ==

operator += (''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра.

== оператор << ==

Эквивалент оператора <tt>[[#оператор +|+]]</tt>.

== getc ==

getc(''позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, на который указывает переданный итератор.

== get ==

get(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== setc ==

setc(''позиция'': <tt>[[string_iterator]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, на который указывает переданный итератор.

== set ==

set(''индекс'': <tt>[[int]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== at ==

set(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу.

== empty ==

'''Возвращает''': [[логическое значение]] 

Метод проверяет строку на наличие в ней данных.

== length ==

'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает длину строки в символах.

== clear ==

'''Возвращает''': текущий объект 

Очищает строку от содержимого. После этого строка считается пустой.

== substr ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора.

== substr_int ==

substr_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#substr|substr]]</tt>, только начальная позиция принимается в виде числа.

<source lang="kpp" line="1">
export function void main() {
var string word = "Hello";
for(var int i=0;i<word.length(); i++) {
puts(word.substr_int(i,1));
}
}
</source>

Вернет:
;H
;e
;l
;l
;o

<source lang="kpp" line="1">
export function void main() {
puts("Hello_world!".substr_int(6,6));
}
</source>
Вернет:
world!

== copy ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает подстроку исходной строки по указанным позициям.

== copy_int ==

copy_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#copy|copy]]</tt>, только позиции принимаются в виде чисел.

== replace ==

replace(''начальная позиция'': <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод заменяет подстроку исходной строки на данные, предоставленные пользователем.

== replace_int ==

replace(''начальная позиция'': <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод аналогичен методу <tt>[[#replace|replace]]</tt>, только позиция передается в виде числа.

== replace_rel ==

== replace_rel_int ==

== replace_all ==

replace_all(''подстрока поиска'': <tt>string</tt>, ''подстрока замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены.

== insert ==

insert(''позиция'': <tt>[[string_iterator]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод вставляет переданную строку в исходную, в месте, указанном итератором.

== insert_int ==

insert(''позиция'': <tt>[[int]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#insert|insert]]</tt>, только позиция передается числом.

== erase ==

erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': текущий объект 

Метод вырезает из исходной строки соответствующую подстроку.

== erase_int ==

erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#erase|erase]]</tt>, только позиция передается числом.

== find ==

find(''подстрока поиска'': <tt>string</tt>, ''начальная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию.

== find_first_of ==

== find_first_not_of ==

== begin ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на начало строки.

== end ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на конец строки.

'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.

String

2009-06-12T16:00:48Z

Humbug: /* substr_int */

Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок. Важно отметить, что все строки хранятся и обрабатываются в кодировке '''UTF-8'''. Например, метод <tt>[[#length|length]]</tt> для этого класса, возвращает длинну строки в символах, а не в байтах. Таким образом, реальный размер строки, содержащей многобайтные символы, не будет совпадать с ее длиной. При необходимости работы со строками как с потоком байтов, следует использовать класс <tt>[[bytea]]</tt>.

Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием [[регулярных выражений]].

'''Родители''': <tt>[[Object]]</tt> 
'''Методы''': <tt>
[[#getc|getc]]
[[#get|get]]
[[#setc|setc]]
[[#set|set]]
[[#at|at]]
[[#empty|empty]]
[[#length|length]]
[[#clear|clear]]
[[#substr|substr]]
[[#substr_int|substr_int]]
[[#copy|copy]]
[[#copy_int|copy_int]]
[[#replace|replace]]
[[#replace_int|replace_int]]
[[#replace_rel_|replace_rel]]
[[#replace_rel_int|replace_rel_int]]
[[#replace_all|replace_all]]
[[#insert|insert]]
[[#insert_int|insert_int]]
[[#erase|erase]]
[[#erase_int|erase_int]]
[[#find|find]]
[[#find_first_of|find_first_of]]
[[#find_first_not_of|find_first_not_of]]
[[#begin|begin]]
[[#end|end]]</tt> 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> 
'''Реализует операторы''':
<tt>[[#оператор +|+]]</tt>,
<tt>[[#оператор +=|+=]]</tt>,
<tt>[[#оператор <<|<<]]</tt>,
[[оператор присваивания|присваивания]],
[[операторы сравнения|сравнения]] 

__NOTOC__

== оператор + ==

operator + (''строка'': <tt>string</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк.

== оператор += ==

operator += (''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра.

== оператор << ==

Эквивалент оператора <tt>[[#оператор +|+]]</tt>.

== getc ==

getc(''позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, на который указывает переданный итератор.

== get ==

get(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== setc ==

setc(''позиция'': <tt>[[string_iterator]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, на который указывает переданный итератор.

== set ==

set(''индекс'': <tt>[[int]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== at ==

set(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу.

== empty ==

'''Возвращает''': [[логическое значение]] 

Метод проверяет строку на наличие в ней данных.

== length ==

'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает длину строки в символах.

== clear ==

'''Возвращает''': текущий объект 

Очищает строку от содержимого. После этого строка считается пустой.

== substr ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора.

== substr_int ==

substr_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#substr|substr]]</tt>, только начальная позиция принимается в виде числа.

<source lang="kpp" line="1">
export function void main() {
var string x = "Hello";
for(var int i=0;i<x.length(); i++) {
var y = x.substr_int(i,1);
puts(y);
}
}
</source>

Вернет:
;H
;e
;l
;l
;o

<source lang="kpp" line="1">
export function void main() {
var string x = "Hello_world!";
var y = x.substr_int(6,6);
puts(y);
}
</source>
Вернет:
world!

== copy ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает подстроку исходной строки по указанным позициям.

== copy_int ==

copy_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#copy|copy]]</tt>, только позиции принимаются в виде чисел.

== replace ==

replace(''начальная позиция'': <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод заменяет подстроку исходной строки на данные, предоставленные пользователем.

== replace_int ==

replace(''начальная позиция'': <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод аналогичен методу <tt>[[#replace|replace]]</tt>, только позиция передается в виде числа.

== replace_rel ==

== replace_rel_int ==

== replace_all ==

replace_all(''подстрока поиска'': <tt>string</tt>, ''подстрока замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены.

== insert ==

insert(''позиция'': <tt>[[string_iterator]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод вставляет переданную строку в исходную, в месте, указанном итератором.

== insert_int ==

insert(''позиция'': <tt>[[int]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#insert|insert]]</tt>, только позиция передается числом.

== erase ==

erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': текущий объект 

Метод вырезает из исходной строки соответствующую подстроку.

== erase_int ==

erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#erase|erase]]</tt>, только позиция передается числом.

== find ==

find(''подстрока поиска'': <tt>string</tt>, ''начальная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию.

== find_first_of ==

== find_first_not_of ==

== begin ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на начало строки.

== end ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на конец строки.

'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.

String

2009-06-12T15:59:46Z

Humbug: /* copy */

Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок. Важно отметить, что все строки хранятся и обрабатываются в кодировке '''UTF-8'''. Например, метод <tt>[[#length|length]]</tt> для этого класса, возвращает длинну строки в символах, а не в байтах. Таким образом, реальный размер строки, содержащей многобайтные символы, не будет совпадать с ее длиной. При необходимости работы со строками как с потоком байтов, следует использовать класс <tt>[[bytea]]</tt>.

Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием [[регулярных выражений]].

'''Родители''': <tt>[[Object]]</tt> 
'''Методы''': <tt>
[[#getc|getc]]
[[#get|get]]
[[#setc|setc]]
[[#set|set]]
[[#at|at]]
[[#empty|empty]]
[[#length|length]]
[[#clear|clear]]
[[#substr|substr]]
[[#substr_int|substr_int]]
[[#copy|copy]]
[[#copy_int|copy_int]]
[[#replace|replace]]
[[#replace_int|replace_int]]
[[#replace_rel_|replace_rel]]
[[#replace_rel_int|replace_rel_int]]
[[#replace_all|replace_all]]
[[#insert|insert]]
[[#insert_int|insert_int]]
[[#erase|erase]]
[[#erase_int|erase_int]]
[[#find|find]]
[[#find_first_of|find_first_of]]
[[#find_first_not_of|find_first_not_of]]
[[#begin|begin]]
[[#end|end]]</tt> 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> 
'''Реализует операторы''':
<tt>[[#оператор +|+]]</tt>,
<tt>[[#оператор +=|+=]]</tt>,
<tt>[[#оператор <<|<<]]</tt>,
[[оператор присваивания|присваивания]],
[[операторы сравнения|сравнения]] 

__NOTOC__

== оператор + ==

operator + (''строка'': <tt>string</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк.

== оператор += ==

operator += (''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра.

== оператор << ==

Эквивалент оператора <tt>[[#оператор +|+]]</tt>.

== getc ==

getc(''позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, на который указывает переданный итератор.

== get ==

get(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== setc ==

setc(''позиция'': <tt>[[string_iterator]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, на который указывает переданный итератор.

== set ==

set(''индекс'': <tt>[[int]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== at ==

set(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу.

== empty ==

'''Возвращает''': [[логическое значение]] 

Метод проверяет строку на наличие в ней данных.

== length ==

'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает длину строки в символах.

== clear ==

'''Возвращает''': текущий объект 

Очищает строку от содержимого. После этого строка считается пустой.

== substr ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора.

== substr_int ==

substr_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#substr|substr]]</tt>, только начальная позиция принимается в виде числа.

== copy ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает подстроку исходной строки по указанным позициям.

== copy_int ==

copy_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#copy|copy]]</tt>, только позиции принимаются в виде чисел.

== replace ==

replace(''начальная позиция'': <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод заменяет подстроку исходной строки на данные, предоставленные пользователем.

== replace_int ==

replace(''начальная позиция'': <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод аналогичен методу <tt>[[#replace|replace]]</tt>, только позиция передается в виде числа.

== replace_rel ==

== replace_rel_int ==

== replace_all ==

replace_all(''подстрока поиска'': <tt>string</tt>, ''подстрока замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены.

== insert ==

insert(''позиция'': <tt>[[string_iterator]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод вставляет переданную строку в исходную, в месте, указанном итератором.

== insert_int ==

insert(''позиция'': <tt>[[int]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#insert|insert]]</tt>, только позиция передается числом.

== erase ==

erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': текущий объект 

Метод вырезает из исходной строки соответствующую подстроку.

== erase_int ==

erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#erase|erase]]</tt>, только позиция передается числом.

== find ==

find(''подстрока поиска'': <tt>string</tt>, ''начальная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию.

== find_first_of ==

== find_first_not_of ==

== begin ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на начало строки.

== end ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на конец строки.

'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.

String

2009-06-12T15:55:00Z

Humbug: /* copy */

Класс <tt>string</tt> используется для хранения и обработки стороковых данных. Класс предоставляет большое количество методов для управления строками, таких как: выделение, поиск и замена подстрок. Важно отметить, что все строки хранятся и обрабатываются в кодировке '''UTF-8'''. Например, метод <tt>[[#length|length]]</tt> для этого класса, возвращает длинну строки в символах, а не в байтах. Таким образом, реальный размер строки, содержащей многобайтные символы, не будет совпадать с ее длиной. При необходимости работы со строками как с потоком байтов, следует использовать класс <tt>[[bytea]]</tt>.

Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, [[K++#Системная библиотека|библиотека языка K++]] вводит операторы <tt>[]</tt> и <tt>[]=</tt> для упрощения работы со строками. Дополнительно, там же вводятся операции с использованием [[регулярных выражений]].

'''Родители''': <tt>[[Object]]</tt> 
'''Методы''': <tt>
[[#getc|getc]]
[[#get|get]]
[[#setc|setc]]
[[#set|set]]
[[#at|at]]
[[#empty|empty]]
[[#length|length]]
[[#clear|clear]]
[[#substr|substr]]
[[#substr_int|substr_int]]
[[#copy|copy]]
[[#copy_int|copy_int]]
[[#replace|replace]]
[[#replace_int|replace_int]]
[[#replace_rel_|replace_rel]]
[[#replace_rel_int|replace_rel_int]]
[[#replace_all|replace_all]]
[[#insert|insert]]
[[#insert_int|insert_int]]
[[#erase|erase]]
[[#erase_int|erase_int]]
[[#find|find]]
[[#find_first_of|find_first_of]]
[[#find_first_not_of|find_first_not_of]]
[[#begin|begin]]
[[#end|end]]</tt> 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> 
'''Реализует операторы''':
<tt>[[#оператор +|+]]</tt>,
<tt>[[#оператор +=|+=]]</tt>,
<tt>[[#оператор <<|<<]]</tt>,
[[оператор присваивания|присваивания]],
[[операторы сравнения|сравнения]] 

__NOTOC__

== оператор + ==

operator + (''строка'': <tt>string</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает новую строку, полученную путем конкатенации (сложения) текущей и переданной строк.

== оператор += ==

operator += (''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод изменяет текущую строку, дописывая ей в конец строку, переданную в качестве параметра.

== оператор << ==

Эквивалент оператора <tt>[[#оператор +|+]]</tt>.

== getc ==

getc(''позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, на который указывает переданный итератор.

== get ==

get(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== setc ==

setc(''позиция'': <tt>[[string_iterator]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, на который указывает переданный итератор.

== set ==

set(''индекс'': <tt>[[int]]</tt>, ''новый код'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.

== at ==

set(''индекс'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод создает строковый итератор и инициализирует его так, чтобы он указывал на символ по переданному индексу.

== empty ==

'''Возвращает''': [[логическое значение]] 

Метод проверяет строку на наличие в ней данных.

== length ==

'''Возвращает''': <tt>[[int]]</tt> 

Метод возвращает длину строки в символах.

== clear ==

'''Возвращает''': текущий объект 

Очищает строку от содержимого. После этого строка считается пустой.

== substr ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает указанное количество символов исходной строки, начиная с позиции итератора.

== substr_int ==

substr_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#substr|substr]]</tt>, только начальная позиция принимается в виде числа.

== copy ==

substr(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод возвращает подстроку исходной строки по указанным позициям.

<source lang="kpp" line="1">
export function void main() {
var string x = "Hello";
for(var int i=0;i<x.length(); i++) {
var y = x.substr_int(i,1);
puts(y);
}
}
</source>

Вернет:
;H
;e
;l
;l
;o

== copy_int ==

copy_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) 
'''Возвращает''': <tt>string</tt> 

Метод аналогичен методу <tt>[[#copy|copy]]</tt>, только позиции принимаются в виде чисел.

== replace ==

replace(''начальная позиция'': <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод заменяет подстроку исходной строки на данные, предоставленные пользователем.

== replace_int ==

replace(''начальная позиция'': <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>, ''строка замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод аналогичен методу <tt>[[#replace|replace]]</tt>, только позиция передается в виде числа.

== replace_rel ==

== replace_rel_int ==

== replace_all ==

replace_all(''подстрока поиска'': <tt>string</tt>, ''подстрока замены'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод находит все включения подстроки поиска в исходной строке и заменяет их на подстроку замены.

== insert ==

insert(''позиция'': <tt>[[string_iterator]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

Метод вставляет переданную строку в исходную, в месте, указанном итератором.

== insert_int ==

insert(''позиция'': <tt>[[int]]</tt>, ''строка'': <tt>string</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#insert|insert]]</tt>, только позиция передается числом.

== erase ==

erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': текущий объект 

Метод вырезает из исходной строки соответствующую подстроку.

== erase_int ==

erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) 
'''Возвращает''': текущий объект 

То же, что и метод <tt>[[#erase|erase]]</tt>, только позиция передается числом.

== find ==

find(''подстрока поиска'': <tt>string</tt>, ''начальная позиция'': <tt>[[string_iterator]]</tt>) 
'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод ищет в исходной строке искомую подстроку и возвращает итератор начала вхождения. Для поиска подстроки, начиная с некоторой позиции, может быть передан второй параметр — итератор, установленный на нужную позицию.

== find_first_of ==

== find_first_not_of ==

== begin ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на начало строки.

== end ==

'''Возвращает''': <tt>[[string_iterator]]</tt> 

Метод возвращает указатель на конец строки.

'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.