String — различия между версиями

Материал из Deeptown Manual
Перейти к: навигация, поиск
м (erase)
 
(не показаны 77 промежуточных версий 5 участников)
Строка 31: Строка 31:
 
[[#find_first_not_of|find_first_not_of]]  
 
[[#find_first_not_of|find_first_not_of]]  
 
[[#begin|begin]]  
 
[[#begin|begin]]  
[[#end|end]]
+
[[#end|end]]</tt><br>
[[#dup|dup]] </tt><br>
+
 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> <br>
 
'''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[bytea]]</tt> <br>
 
'''Реализует операторы''':  
 
'''Реализует операторы''':  
Строка 73: Строка 72:
 
'''Возвращает''': <tt>[[int]]</tt> <br>
 
'''Возвращает''': <tt>[[int]]</tt> <br>
  
Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение [[Классы исключений#ERangeError|ERangeError]].
+
Метод возвращает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.
  
 
== setc ==
 
== setc ==
Строка 87: Строка 86:
 
'''Возвращает''': текущий объект <br>
 
'''Возвращает''': текущий объект <br>
  
Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение [[Классы исключений#ERangeError|ERangeError]].
+
Метод устанавливает числовой код символа, расположенного по переданному индексу (смещение относительно начала строки). При передаче индекса, выходящего за границы строки, будет возбуждено исключение <tt>[[Классы исключений#ERangeError|ERangeError]]</tt>.
  
 
== at ==
 
== at ==
Строка 183: Строка 182:
 
== erase ==
 
== erase ==
  
erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''конечная позиция'': <tt>[[string_iterator]]</tt>) <br>
+
erase(''начальная позиция:'' <tt>[[string_iterator]]</tt>, ''количество символов'': <tt>[[string_iterator]]</tt>) <br>
 
'''Возвращает''': текущий объект <br>
 
'''Возвращает''': текущий объект <br>
  
Строка 190: Строка 189:
 
== erase_int ==
 
== erase_int ==
  
erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''конечная позиция'': <tt>[[int]]</tt>) <br>
+
erase_int(''начальная позиция:'' <tt>[[int]]</tt>, ''количество символов'': <tt>[[int]]</tt>) <br>
 
'''Возвращает''': текущий объект <br>
 
'''Возвращает''': текущий объект <br>
  
То же, что и метод <tt>[[#erase|erase]]</tt>, только позиции передаются числами.
+
То же, что и метод <tt>[[#erase|erase]]</tt>, только позиция передается числом.
  
 
== find ==
 
== find ==
  
find(''подстрока поиска'': <tt>string</tt> [, ''начальная позиция'': <tt>[[string_iterator]]</tt>]) <br>
+
find(''подстрока поиска'': <tt>string</tt>, <span style="background-color: #EBEBEB;">''начальная позиция'': <tt>[[string_iterator]]</tt></span>) <br>
 
'''Возвращает''': <tt>[[string_iterator]]</tt> <br>
 
'''Возвращает''': <tt>[[string_iterator]]</tt> <br>
  
Строка 219: Строка 218:
  
 
'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.
 
'''Примечание''': Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор <tt>[[string_iterator#оператор --|string_iterator:--]]</tt>, для движения по строке в обратную сторону.
 
== dup ==
 
 
'''Возвращает''': <tt>[[string]]</tt> <br>
 
 
Метод возвращает копию строки.
 

Текущая версия на 13:38, 13 июля 2013

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

Стандартные библиотеки конкретных языков расширяют функциональность данного класса, вводя дополнительные методы. Например, библиотека языка 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
Приводится к типам: 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_int

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

То же, что и метод erase, только позиция передается числом.

[править] find

find(подстрока поиска: string, начальная позиция: string_iterator)
Возвращает: string_iterator

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

[править] find_first_of

[править] find_first_not_of

[править] begin

Возвращает: string_iterator

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

[править] end

Возвращает: string_iterator

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

Примечание: Под "концом строки" здесь понимается позиция за последним символом строки. Таким образом, данный итератор не указывает на данные строки, а служит только как маркер конца строки. Конечно, при желании, можно использовать оператор string_iterator:--, для движения по строке в обратную сторону.

Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
информация
документация
Инструменты