• Уважаемые гости и новички, приветствуем Вас на нашем форуме
    Здесь вы можете найти ответы практически на все свои вопросы о серии игр «Готика» (в том числе различных модах на нее), «Ведьмак», «Ризен», «Древние свитки», «Эра дракона» и о многих других играх. Можете также узнать свежие новости о разработке новых проектов, восхититься творчеством наших форумчан, либо самим показать, что вы умеете. Ну и наконец, можете обсудить общие увлечения или просто весело пообщаться с посетителями «Таверны».

    Чтобы получить возможность писать на форуме, оставьте сообщение в этой теме.
    Удачи!
  • Друзья, доброго времени суток! Спешите принять участие в конкурсе "Таинственные миры" 2024!
    Ждем именно вас!

    Ссылка на конкурсную тему - тык

Union.String - краткое описание класса

Gratt


Модостроитель
Регистрация
14 Ноя 2014
Сообщения
3.276
Благодарности
4.579
Баллы
625
Назначение: строки
Определение: string, astring, wstring
- Конструкторы:
Код:
string();
    Создает пустую строку.
string( const string& str );
    Создает копию строки str.
string( const char& sym );
    Создает копию символа sym.
string( const char* vec );
    Создает копию C-строки vec.
string( const char* vec, const uint& len );
    Создает копию C-строки vec длиною len.
string( const byte& sym );
    Создает копию байта sym.
string( const int& val, const uint& rad = 10 );
    Создает копию целого числа val в разрядности rad.
string( const uint& val, const uint& rad = 10 );
    Создает копию целого беззнакового числа val в разрядности rad.
string( const long32& val, const uint& rad = 10 );
    Создает копию целого числа val в разрядности rad.
string( const ulong32& val, const uint& rad = 10 );
    Создает копию целого беззнакового числа val в разрядности rad.
string( const int64& val, const uint& rad = 10 );
    Создает копию целого длинного числа val в разрядности rad.
string( const uint64& val, const uint& rad = 10 );
    Создает копию целого беззнакового длинного числа val в разрядности rad.
string( const float& val, const uint& dig = 3 );
    Создает копию вещественного числа val в разрядности rad.
string( const double& val, const uint& dig = 3 );
    Создает копию вещественного длинного числа val в разрядности rad.
- Операторы:
Код:
string operator + ( const string& str ) const;
    Создает текущей строки и вставляет в конец строку str
string operator + ( const char* vec ) const;
    Создает текущей строки и вставляет в конец строку vec
string& operator += ( const string& str );
    Вставляет в конец текущей строки подстроку str
string& operator += ( const char* vec );
    Вставляет в конец текущей строки подстроку var
string& operator = ( const string& str );
    Приравнивает текущую строку к строке str
string& operator = ( const char* vec );
    Приравнивает текущую строку к строке vec
bool operator == ( const string& str ) const;
    Определяет не равна ли текущая строка со строкой str. Возвращает true, если строки равны.
bool operator == ( const char* vec ) const;
    Определяет не равна ли текущая строка со строкой vec. Возвращает true, если строки равны.
bool operator != ( const string& str ) const;
    Определяет не равна ли текущая строка со строкой str. Возвращает true, если строки не равны.
bool operator != ( const char* vec ) const;
    Определяет не равна ли текущая строка со строкой vec. Возвращает true, если строки не равны.
bool operator > ( const string& str ) const;
    Определяет, старше ли текущая строка в алфавитном порядке, чем строка str. Возвращает true, если старше.
bool operator < ( const string& str ) const;
    Определяет, младше ли текущая строка в алфавитном порядке, чем строка str. Возвращает true, если младше.
char& operator [] ( const int& idx );
    Возвращает символ строки по индексу idx
const char& operator [] ( const int& idx ) const;
    Возвращает символ строки по индексу idx
operator const char* ( ) const;
    Представляет текущую строку как C-строку
- Методы:
Код:
char& First()
    Возвращает первый символ строки
const char& First() const
    Возвращает первый символ строки
char& Last()
    Возвращает последний символ строки
const char& Last() const
    Возвращает последний символ строки
bool IsA() const
    Определяет является ли объект строкой ANSI
bool IsW() const
    Определяет является ли объект строкой UNICODE
uint Toint( const uint& rad = 10 ) const
    Преобразует строку в целое число в разрядности rad
uint64 ToInt64( const uint& fromRad = 10 ) const
    Преобразует строку в длинное целое число в разрядности rad
float Tofloat() const
    Преобразует строку в вещественное число в разрядности rad
double Todouble() const
    Преобразует строку в длинное вещественное число в разрядности rad
bool IsNumber() const
    Определяет является ли объект строковым эквивалентом числа
bool IsHexNumber() const
    Определяет является ли объект строковым эквивалентом HEX числа
char* ToChar()
    Возвращает набор символов строки
const char* GetVector() const
    Возвращает набор символов строки
uint Length() const
    Возвращает длину строки
uint Allocated() const
    Возвращает количество выделенной памяти под строку
bool IsEmpty() const
    Возвращает логическое значение, является ли строка пустой
bool Compare( const string& str ) const
    Сравнивает текущую строку со строкой str и возвращает логическое значение
bool Compare( const char* vec ) const
    Сравнивает текущую строку со строкой vec и возвращает логическое значение
bool CompareI( const string& str ) const
    Сравнивает текущую строку со строкой str без учета регистра и возвращает логическое значение
bool CompareI( const char* vec ) const
    Сравнивает текущую строку со строкой vec без учета регистра и возвращает логическое значение
bool CompareMasked( const string& str ) const
    Сравнивает текущую строку со строкой-маской str и возвращает логическое значение
    Пример маски: AI_*GUARD.*S
bool CompareMaskedI( const string& str ) const
    Сравнивает текущую строку со строкой-маской str без учета регистра и возвращает логическое значение
    Пример маски: AI_*GUARD.*S
uint Search( const string& cmp, const uint& pos = 0, const bool& end = False ) const
    Ищет в текущей строке подстроку cmp, начиная с позиции pos и возвращает индекс начала подстроки, либо ее конца, если end = True. Иначе -1
uint SearchI( const string& cmp, const uint& pos = 0, const bool& end = False ) const
    Ищет в текущей строке подстроку cmp без учета регистра, начиная с позиции pos и возвращает индекс начала подстроки, либо ее конца, если end = True. Иначе -1
uint SearchReverse( const string& cmp, const uint& pos = 0, const bool& end = False ) const
    Ищет в текущей строке подстроку cmp в обратном порядке, начиная с позиции pos и возвращает индекс начала подстроки, либо ее конца, если end = True. Иначе -1
uint SearchReverseI( const string& cmp, const uint& pos = 0, const bool& end = False ) const
    Ищет в текущей строке подстроку cmp в обратном порядке без учета регистра, начиная с позиции pos и возвращает индекс начала подстроки, либо ее конца, если end = True. Иначе -1
bool HasWord( const string& cmp ) const
    Определяет имеется ли в текущей строке подстрока cmp
bool HasWordI( const string& cmp ) const
    Определяет имеется ли в текущей строке подстрока cmp без учета регистра
bool MatchesMask( const string& mask ) const
    Определяет принадлежит ли текущая строка набору символов из подстроки mask
bool StartWith( const string& cmp ) const
    Определяет начинается ли текущая строка с подстроки cmp
bool EndWith( const string& cmp ) const
    Определяет заканчивается ли текущая строка подстрокой cmp
string GetWord( const string& mask = " \t", const int& num = 1 ) const
    Извлекает и возвращает из текущей строки подстроку с разделителем mask и порядковым номером num.
    При ошибке возвращает пустую строку.
    Порядковый номер начинается с 1 или -1 (тогда поиск будет начат с конца)
string GetWordEx( const string& mask = " \t", const int& num = 1, const uint& offset = 0, uint* idx = Null ) const
    Извлекает и возвращает из текущей строки подстроку с разделителем mask и порядковым номером num, начиная с позиции offset, а индекс обнаружения будет возвращен в idx.
    При ошибке возвращает пустую строку
    Порядковый номер начинается с 1 или -1 (тогда поиск будет начат с конца)
string GetPattern( const string& lmask, const string& rmask, const int& num = 1 ) const
    Извлекает из текущей строки подстроку, заключенную между lmask и rmask с порядковым номером num.
    При ошибке возвращает пустую строку
    Порядковый номер начинается с 1 или -1 (тогда поиск будет начат с конца)
string GetPatternEx( const string& lmask, const string& rmask, const int& num = 1, const uint& offset = 0, uint* idx = Null ) const
    Извлекает из текущей строки подстроку, заключенную между lmask и rmask с порядковым номером num, начиная с позиции offset, а индекс обнаружения будет возвращен в idx.
    При ошибке возвращает пустую строку
    Порядковый номер начинается с 1 или -1 (тогда поиск будет начат с конца)
Array<string> Split( const string& separator ) const
    Делит строку на подстроки разделителем separator и возвращает массив строк
string GetWordSmart( const int& word_index = 1, const bool& groupSymbols = false ) const
    Извлекает из строки подстроку с порядковым номером word_index, автоматически выбирая разделитель.
    Если groupSymbols истина, то группы символьных букв будут объединяться в одну подктроку.
    При ошибке возвращает пустую строку
    Порядковый номер начинается с 1 или -1 (тогда поиск будет начат с конца)
string GetWordSmartEx( const int& word_index = 1, const bool& groupSymbols = false, const uint& offset = 0, uint* word_offset = Null ) const
    Извлекает из строки подстроку с порядковым номером word_index, автоматически выбирая разделитель.
    Поиск будет начат с позиции offset, а индекс обнаружения будет возвращен в word_offset.
    Если groupSymbols истина, то группы символьных букв будут объединяться в одну подктроку.
    При ошибке возвращает пустую строку
    Порядковый номер начинается с 1 или -1 (тогда поиск будет начат с конца)
string& Reverse()
    Инвертирует положение символов текущей строки.
void Clear()
    Очищает текущую строку.
string Copy( const uint& idx, const uint& len ) const
    Извлекает из текущей строки подстроку начиная с idx длиною len
string& Cut( const uint& len )
    Обрезает конец текущей строки на len символов
string& Cut( const uint& idx, const uint& len )
    Обрезает текущую строку начиная с idx длиною len
string& Put( const string& str, const uint& idx )
    Вставляет в текущую строку подстроку str в позицию idx
string& Put( const char* vec, const uint& idx )
    Вставляет в текущую строку подстроку vec в позицию idx
string& Put( const string& str, const uint& idx, const uint count )
    Вставляет в текущую строку подстроку str в позицию idx count  раз
string& Put( const char* vec, const uint& idx, const uint count )
    Вставляет в текущую строку подстроку str в позицию idx count  раз
string& Replace( const string& ptr1, const string& ptr2, bool looped = false )
    Заменяет в текущей строке все подстроки ptr1 на ptr2.
    Если looped, то программа будет повторно проверять замененные диапазоны на наличие ptr1.
string& Shrink()
    Обрезает все пустые символы в начале и конце текущей строки
string& Shrink( char sym )
    Обрезает все символы sym в начале и конце текущей строки
string& ShrinkFront()
    Обрезает все пустые символы в начале текущей строки
string& ShrinkFront( char sym )
    Обрезает все символы sym в начале текущей строки
string& ShrinkBack()
    Обрезает все пустые символы в конце текущей строки
string& ShrinkBack( char sym )
    Обрезает все символы sym в конце текущей строки
wstring AToW( const uint& srcCodePage = ANSI_CODEPAGE_DEFAULT ) const
    Возвращает копию текущей ANSI строки в виде UNICODE строки с учетом кодовой страницы srcCodePage
string WToA( const uint& srcCodePage = ANSI_CODEPAGE_DEFAULT ) const
    Возвращает копию текущей UNICODE строки в виде ANSI строки с учетом кодовой страницы srcCodePage
string& Upper()
    Делает все символы строки прописными
string& Lower()
    Делает все символы строки строчными
string& LowerFirstUpper()
    Делает первый символ строки прописным, все остальные строчными
Array<string> Regex_Search( const string& pattern ) const
    При помощи регулярных выражений находит в текущей строке все вхождения, совпадающих с шаблоном pattern
string Regex_Match( const string& pattern ) const
    При помощи регулярных выражений находит в текущей строке первое вхождение, совпадающее с шаблоном pattern
void Regex_Replace( const string& pattern, const string& newSubStr )
    При помощи регулярных выражений заменяет в текущей строке все вхождения, совпадающих с шаблоном pattern на подстроку newSubStr
bool WriteToFile( const string& fname, const bool& createDirs = True ) const
    Записывает строку в файл fname.
    Если createDirs истина, то программа автоматически создаст все недостающие каталоги в заданном пути.
    Если операция проходит успешно, то функция вернет True.
bool WriteToFileUTF8( const string& fname, const bool& createDirs = True ) const
    Записывает строку в файл fname в кодировке UTF8.
    Если createDirs истина, то программа автоматически создаст все недостающие каталоги в заданном пути.
    Если операция проходит успешно, то функция вернет True.
bool ReadFromFile( const string& fname )
    Читает строку из файла fname.
    Если операция проходит успешно, то функция вернет True.
bool ReadFromFile( const wstring& fname )
    Читает строку из файла fname.
    Если операция проходит успешно, то функция вернет True.
bool ReadFromVdf( const string& fname, const long32& flags )
    Читает строку из виртуального файла fname с флагами flags.
    Флаги:
        VDF_VIRTUAL         - читаться будут только виртуальные файлы.
        VDF_PHYSICAL        - читаться будут только физические файлы.
        VDF_PHYSICALFIRST   - вначале читать физические, если указаны оба флага одновременно.
    Если операция проходит успешно, то функция вернет True.
static string Hex32( const uint& val )
    Создает строку, соответствующую HEX представлению числа val
static string Hex64( const uint64& val )
    Создает строку, соответствующую HEX представлению числа val
static string Combine( const char* format ... )
    Создает строку, используя шаблон и входящие в него аргументы.
    %i - взять целое число
    %I - взять длинное целое число
    %u - взять беззнаковое целое число
    %U - взять беззнаковое длинное целое число
    %x - взять число в HEX представлении
    %X - взять длинное число в HEX представлении
    %f - взять вещественное число
    %F - взять длинное вещественное число
    %b - взять логическое значение
    %c - взять символ
    %B - взять байт
    %t - взять C-строку
    %s - взять Union.string
    %z - взять любую ANSI строку
    %r - вставить разелитель из символов '-'
 
Последнее редактирование:

Gratt


Модостроитель
Регистрация
14 Ноя 2014
Сообщения
3.276
Благодарности
4.579
Баллы
625
Назначение: мульти-строки
Определение: rowString

// TO DO
 
Сверху Снизу