Таблица
7.3.
Функции для работы с текстом
Функция/Метод |
Синтаксис |
Описание |
Пример |
Язык С++. Функции ClassLib Borland C/C++ |
Header File |
cstring.h |
|
|
Конструкторы: |
string::string |
|
|
Данные - члены класса: |
StripType |
|
|
Публичные методы: |
|
|
|
ansi_to_oem |
void ansi_to_oem(); |
перевод текста строки из кодировки ANSI в кодировку OEM (согласно установленному национальному стандарту) |
|
append |
string _FAR & append( const string _FAR &s ); string _FAR & append( const string _FAR &s, size_t start, size_t n = NPOS );
string _FAR & append( const char _FAR *cp, size_t start, size_t n = NPOS );
|
добавляет заданную строку s к текущей строке. |
|
assign |
string _FAR & assign( const string _FAR &s ); string _FAR & assign( const string _FAR &s, size_t start, size_t n = NPOS );
|
|
|
compare |
int compare(const string _FAR &s) const throw(); int compare(const string _FAR &s, size_t orig, size_t n = NPOS ) const throw();
|
строка s сравнивается с исходной строкой в лексикографическом порядке, и выдается значение: меньше нуля, если исходная строка меньше s, 0, когда строки равны и больше нуля, когда исходная строка больше s. |
|
contains |
int contains(const char _FAR * pat) const; int contains(const string _FAR & s) const;
|
проверяется вхождение строки s (или pat) в текущую строку. Возвращает 1 если строка входит в текущую строку, и 0, если не входит. |
|
copy |
size_t copy( char _FAR *cb, size_t n = NPOS ); size_t copy( char _FAR *cb, size_t n, size_t pos );
string copy() const throw( xalloc ).;
|
функция копирует n символов в строку cb из текущей строки. Возвращает точное число скопированных символов. В третьей форме синтаксиса функция возвращает собственную копию; |
|
c_str |
const char _FAR *c_str() const; |
|
|
find |
size_t find( const string _FAR &s ); size_t find( const string _FAR &s, size_t pos );
|
Возвращает позицию первого вхождения подстроки s в текущую строку. |
|
find |
size_t find( const TRegexp _FAR &pat, size_t i = 0 ); size_t find( const TRegexp _FAR &pat, size_t _FAR *ext, size_t i = 0 ) const;
|
Возвращает позицию первого вхождения подстроки с шаблоном регулярного выражения pat в текущую строку, начиная с позиции i. Число i сообщает длину строки, совпадшей с шаблоном. |
|
find_first_of |
size_t find_first_of( const string _FAR &s ) const; size_t find_first_of( const string _FAR &s, size_t pos ) const;
|
возвращает первый символ из текущей строки, совпавший с любым символом из строки s. |
|
find_first_not_of |
size_t find_first_not_of( const string _FAR &s ) const; size_t find_first_not_of( const string _FAR &s, size_t pos ) const;
|
|
|
find_last_of |
size_t find_last_of( const string _FAR &s ) const; size_t find_last_of( const string _FAR &s, size_t pos ) const;
|
|
|
find_last_not_of |
size_t find_last_not_of( const string _FAR &s ) const; size_t find_last_not_of( const string _FAR &s, size_t pos ) const;
|
|
|
get_at |
char get_at( size_t pos ) const throw( outofrange ); |
возвращает символ в указанной позиции pos. |
|
get_case_sensitiveFlag |
static int get_case_sensitive_flag(); |
Возвращает значение 0, если сравнение чувствительно к регистру букв. |
|
get_initial_capacity |
static unsigned get_initial_capacity(); |
|
|
get_max_waste static unsigned get_max_waste(); |
|
|
|
get_paranoid_check |
static int get_paranoid_check(); |
|
|
get_resize_increment |
|
|
|
static unsigned get_resize_increment(); |
|
|
|
get_skipwhitespace_flag |
static int get_skipwhitespace_flag(); |
возвращает 1, если при поиске пропускаются пробельные символы. |
|
hash |
unsigned hash() const; |
Выдает значение хеш величины типа данных; |
|
initial_capacity |
static size_t initial_capacity(size_t ic = 63); |
|
|
insert |
string _FAR &insert( size_t start, const string _FAR &s ); string _FAR &insert( size_t pos, const string _FAR &s, size_t start, size_t n = NPOS );
|
Вставляет pos символов из строки s в текущую строку, начиная с позиции start. |
|
is_null |
int is_null() const; |
Возвращает 1, если строка пустая; |
|
length |
unsigned length() const; |
возвращает длину текущей строки. |
|
MaxWaste |
static size_t MaxWaste(size_t mw = 63); |
задает максимальное число пробельных символов и расширяет строку. |
|
oem_to_ansi |
void oem_to_ansi(); |
функция преобразует строку из кодировки oem в кодировку ANSI согласно указанным региональным стандартам. |
|
prepend |
string _FAR &prepend( const string _FAR &s ); string _FAR &prepend( const string _FAR &s, size_t start, size_t n = NPOS );
string _FAR &prepend( const char _FAR *cp );string _FAR &prepend( const char _FAR *cp, size_t start, size_t n = NPOS );
|
Функция прибавляет к началу текущей строки строку s, начиная с позиции start. |
|
put_at |
void put_at( size_t pos, char c ) throw( outofrange ); |
записывает в позицию pos символ c. |
|
read_file |
istream _FAR &read_file(istream _FAR &is); |
читает файл из входящего потока в строку; |
|
read_line |
istream _FAR &read_line(istream _FAR &is); |
читает строку файла из указанного потока в строку, пока не достигнут знак "перевод строки" или "конец файла". |
|
read_string |
istream _FAR &read_string(istream _FAR &is); |
читает строку файла из указанного потока в строку, пока не достигнут знак "\0" или "конец файла". |
|
read_to_delim |
istream _FAR &read_to_delim(istream _FAR &is, char delim = '\n'); |
читает строку файла из указанного потока в строку, пока не достигнут знак delim или "конец файла". |
|
read_token |
istream _FAR &read_token(istream _FAR &is); |
читает строку файла из указанного потока в строку, пока не достигнут пробельный символ или "конец файла". Пустые строки в начале файла игнорируются. |
|
rfind |
size_t rfind( const string _FAR &s ); size_t rfind( const string _FAR &s, size_t pos );
|
возвращает последний символ из текущей строки, совпавший с любым символом из строки s. |
|
remove |
string _FAR &remove( size_t pos ); string _FAR &remove( size_t pos, size_t n = NPOS );
|
удаляет часть текущей строки (длиной n или до конца строки), начиная с позиции pos. |
|
replace |
string _FAR &replace( size_t pos, size_t n = NPOS, const string _FAR &s ); string _FAR &replace( size_t pos, size_t n1, const string _FAR &s, size_t start, size_t n2 );
|
удаляет, по крайней мере, n (n1) позиций из текущей строки, начиная с позиции pos, и заменяет ее, по крайней мере, n2 позициями строки s, начиная с позиции start (или всей строкой s). |
|
reserve |
size_t reserve() const; void reserve( size_t ic );
|
|
|
resize |
void resize(size_t m); |
увеличивает длину строки на m байт. |
|
resize_increment |
static size_t resize_increment(size_t ri = 64); |
устанавливает инкремент для автоматического изменения длины строки в ri байт. |
|
set_case_sensitive |
static int set_case_sensitive(int tf = 1); |
устанавливает чувствительность к регистру символов при сравнении строк: 1 - чувствительный к регистру, 0 - не чувствительный. |
|
set_paranoid_check |
static int set_paranoid_check(int ck = 1); |
|
|
skip_whitespace |
static int skip_whitespace(int sk = 1); |
Устанавливается в единицу, чтобы пропускать пробельные символы при чтении слов (цепочек), или 0 в противном случае; |
|
strip |
TSubString strip( StripType s = Trailing, char c=' '); |
удалят из текущей строки все пробельные или заполняющие с символы вначале, в конце строки или в обоих направлениях, и выдается ссылка на результирующую строку типа TSubString. |
|
substr |
string substr( size_t pos ) const; string substr( size_t pos, size_t n = NPOS ) const;
|
возвращает подстроку из текущей строки, начинающейся с позиции pos текущей строки. |
|
substring |
TSubString substring( const char _FAR *cp ); const TSubString substring( const char _FAR *cp ) const;
TSubString substring( const char _FAR *cp, size_t start );const TSubString substring( const char _FAR *cp, size_t start ) const;
|
создает объект типа TSubstring, содержащей копию строки cp. |
|
to_lower |
void to_lower(); |
переводит строку в нижний регистр; |
|
to_upper |
void to_upper(); |
переводит символы строки в верхний регистр. |
|
Protected Member Functions |
|
|
|
valid_element |
int valid_element( size_t pos ) const; |
возвращает 1, если в позиции pos находится элемент строки, и 0 в противном случае. |
|
valid_index |
int valid_index( size_t pos ) const; |
возвращает 1, если pos нормальный индекс строки символов, и 0 в противном случае. |
|
assert_element |
|
|
|
assert_index |
|
|
|
cow |
|
|
|
Operators |
=; +=; +=; +; []; (); ==; !=; <; <=; >; >=; |
|
|
Related Global Operators and Functions |
>>; <<; +; getline; to_lower; to_upper; |
|
|