Строки#

Copy(S: string; Index: Integer; Count: Integer) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

CompareText(Text1, Text2: String) Integer#

Функция сравнивает строку Text1 и Text2. Функция возвращает значение:

меньше нуля

если Text1 < Text2

ноль

если Text1 = Text2

больше нуля

если Text1 > Text2

Функция чувствительна к регистру набора символов входных параметров.

Parameters
  • Text1 (String) – Строка для сравнения

  • Text2 (String) – Строка для сравнения

Return type

Integer

AnsiCompareText(Text1, Text2: String) Integer#

Сравнивает строки Text1 и S2 c чувствительностью к регистру. Возвращает следующие значения:

меньше нуля

если Text1 < Text2

ноль

если Text1 = Text2

больше нуля

если Text1 > Text2

Parameters
  • Text1 (String) – Строка для сравнения

  • Text2 (String) – Строка для сравнения

Return type

Integer

CompareStr(Str1, Str2: Variant) Integer#

Функция сравнивает строку Str1 и Str2. Функция возвращает значения:

меньше нуля

если S1 < S2

ноль

если S1 = S2

больше нуля

если S1 > S2

Функция чувствительна к регистру набора символов входных параметров.

Parameters
  • Str1 (Variant) – Строка для сравнения

  • Str2 (Variant) – Строка для сравнения

Return type

Integer

AnsiCompareStr(S1, S2: String) Integer#

Сравнивает строки S1 и S2 c чувствительностью к регистру. Возвращает следующие значения:

меньше нуля

если S1 < S2

ноль

если S1 = S2

больше нуля

если S1 > S2

Parameters
  • S1 (String) – Строка для сравнения

  • S2 (String) – Строка для сравнения

Return type

Integer

AnsiEndsText(SubStr, Str: String) Boolean#

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

Parameters
  • SubStr (String) – подстрока

  • Str (String) – строка

Return type

Boolean

AnsiEndsStr(SubStr, Str: String) Boolean#

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

Parameters
  • SubStr (String) – подстрока

  • Str (String) – строка

Return type

Boolean

AnsiStartsText(SubStr, Str: String) Boolean#

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

Parameters
  • SubStr (String) – подстрока

  • Str (String) – строка

Return type

Boolean

AnsiStartsStr(SubStr, Str: String) Boolean#

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

Parameters
  • SubStr (String) – подстрока

  • Str (String) – строка

Return type

Boolean

ContainsText(Text, SubText: String) Boolean#

Функция возвращет True, если SubText является подстрокой строки Text. Функция является нечувствительной к регистру символов.

Parameters
  • Text (String) – Строка в которой ищется подстрока.

  • SubText (String) – Подстрока.

Return type

Boolean

ContainsStr(Text, SubText: String) Boolean#

Функция возвращет True, если SubText является подстрокой строки Text. Функция является чувствительной к регистру.

Parameters
  • Text (String) – Строка в которой ищется подстрока.

  • SubText (String) – Подстрока.

Return type

Boolean

MidStr(Text: String; Start, Count: Integer) String#

Возвращает подстроку содержащюю Count символов из Text начиная c Start.

Parameters
  • Text (String) – Исходная строка

  • Start (Integer) – Индекс начала подстроки

  • Count (Integer) – Длина подстроки

Return type

String

ReplaceText(Text, FromText, ToText: String) String#

Заменяет все вхождения FromText в строке Text строкой ToText. Функция нечувствительна к регистру набора символов.

Parameters
  • Text (String) – Исходная строка.

  • FromText (String) – Подстрока.

  • ToText (String) – Новая подстрока.

Return type

String

ReplaceStr(Text, FromText, ToText: String) String#

Заменяет все вхождения FromText в строке Text строкой ToText. Функция чувствительна к регистру набора символов.

Parameters
  • Text (String) – Исходная строка.

  • FromText (String) – Подстрока.

  • ToText (String) – Новая подстрока.

Return type

String

Delete(Str, Index, Count: Variant) String#

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

Parameters
  • Str (Variant) – Строка из которой будет удаляться Count символов с символа Index.

  • Index (Variant) – Начало подстроки которую следует удалить.

  • Count (Variant) – Количество символов подстроки.

Return type

String

Warning

В Application Server функция называется deletesubstr

Chr(X: Integer) Char#

Функция возвращает ASCII символ по значению X.

Parameters

X (Integer) – Номер символа в ASCII

Return type

Char

Fmt(FormatStr: String; Params: Array) String#

Форматирует строку, заменяя подстроки {n} на соответствующие параметры.

Parameters
  • FormatStr (String) – Cтрока формата, для подстановки параметров используется ‘{n}’, где n-номер параметра (нумерация с нуля).

  • Params (Array) – Массив параметров, которые будут подставлены в строку формата.

Return type

String

Format(Format: String; Args: Array) String#

Функция выполняет форматирование строки Format с использованием массива аргументов Args.

Parameters
  • Format (String) –

    Строка форматирования. Содержит буквенные символы и спецификаторы формата. Буквенные символы переносятся в результирующую строку. Спецификаторы формата разбирают аргументы из списка и применяют к ним форматирование.

    Спецификаторы формата имеют следующий вид:

    "%" [index ":"] ["-"] [width] ["." prec] type

    Спецификаторы формата начинаются с символа %. После него идут, по порядку:

    • Необязательный параметр - индекс аргумента в списке аргументов (индекс первого элемента - 0), [index ":"]

    • Необязательный параметр - выравнивание по левому краю, ["-"]

    • Необязательный параметр - ширина поля, [width]

    • Необязательный параметр - точность отображения чисел, ["." prec]

    • Тип аргумента из списка, который будет вставлен в строку вместо спецификатора, type

    Возможные типы спецификаторов для вставки в строку

    d

    Decimal. Десятичное целое число. Значение преобразуется в строку десятичных цифр. Если спецификатор формата содержит поле точности, то результирующая строка должна содержать количество цифр, но не менее указанного значения. Если форматируемое значение содержит меньше цифр, оно дополняется слева нулями.

    u

    Unsigned decimal. Аналогично ‘d’, но не выводится знак числа.

    e

    Scientific. Число с плавающей точкой. Значение конвертируется в строку формата "-d.ddd...E+ddd". Отрицательные числа начинаются со знака “-”. Перед десятичной точкой всегда присутствует одна цифра. По умолчанию точность равна 15, если не задан спецификатор точности. После символа экспоненты “Е” всегда стоит знак “+” или “-” и минимум три цифры.

    f

    Fixed. Число с плавающей точкой. Значение конвертируется в строку формата "-ddd.ddd...". Отрицательные числа начинаются со знака “-“. По умолчанию точность равна 2, если не задан спецификатор точности.

    g

    General. Число с плавающей точкой. Значение конвертируется в кратчайшую строку десятичных символов используя формат “Fixed” или “Scientific”. По умолчанию точность равна 15, если не задан спецификатор точности. Конечные нули обрезаются, десятичная точка выводится только в случае необходимости. Если количество цифр слева от десятичной точки меньше или равно точности, либо значеине больше либо равно 0.00001, то при конвертации используется формат “Fixed”. В противном случае используется формат “Scientific”.

    n

    Number. Число с плавающей точкой. Значение конвертируется в строку формата "-d,ddd,ddd.ddd...". Данный формат повторяет формат “Fixed” за исключением того, что результат содержит знаки, отделяющие тысячи

    m

    Money. Число с плавающей точкой. Значение конвертируется в строку, представляющую валюту - добавляется разделитель тысяч и символ валюты после значения.

    p

    Pointer. Указатель. Значение конвертируется в строку из восьми символов, которая отображает значение указателя в шестнадцатеричном виде

    s

    String. Символ (буква), строка.

    x

    Hex. Число в шестнадцатеричном представлении.

  • Args (Array) – Массив аргументов.

Return type

String

Note

Символы разделителей рвзрядов и дробной части берутся из локали пользователя.

Warning

Для денежного формата всегда используется символ рубля. Если есть необходимость использовать другой денежный символ - используйте формат Number и укажите символ литералом.

GetFmtCaption(Name: String; Params: Array) String#

Выражение GetFmtCaption(Name,Params) равно выражению Fmt(GetCaption(Name),Params).

Parameters
  • Name (String) – Системное имя представления понятия

  • Params (Array) – Массив параметров, подставляемых в текст представления понятия.

Return type

String

Trim(S: String) String#

Функция удаляет пробелы в начале и конце строки.

Parameters

S (String) – Строка, которую необходимо обрезать.

Return type

String

TrimLeft(Str: String) String#

Функция удаляет пробелы сначала строки

Parameters

Str (String) – Строка, которую необходимо обрезать.

Return type

String

TrimRight(Str: String) String#

Функция удаляет пробелы в конце строки

Parameters

Str (String) – Строка, которую необходимо обрезать.

Return type

String

LowerCase(Str: String) String#

Функция приводит все символы строки к нижнему регистру.

Parameters

Str (String) – Исходная строка

Return type

String

UpperCase(Str: String) String#

Функция приводит все символы строки к верхнему регистру.

Parameters

Str (String) – Исходная строка

Return type

String

AnsiLowerCase(Str: String) String#

Функция возвращает копию строки Str, преобразованную к нижнему регистру набора символов.

Parameters

Str (String) – Исходная строка

Return type

String

AnsiUpperCase(Str: String) String#

Функция возвращает копию строки Str преобразованную к верхнему регистру набора символов.

Parameters

Str (String) – Исходная строка

Return type

String

StrToTime(Str: String) TDateTime#

Функция возвращает время, преобразуя строку Str к типу TTime.

Parameters

Str (String) – Время в строковом значение.

Return type

TDateTime

StrToDate(Str: String) TDateTime#

Функция преобразует строку Str к типу TDate.

Parameters

Str (String) – Значение даты в строковом представлении.

Return type

TDateTime

StrToDateTime(Value: String) TDateTime#

Преобразует строку Value в значение типа дата-время, согласно строке форматирования установленной в настройках ОС

Parameters

Value (String) – Строковое значение даты-времени

Return type

TDateTime

StrToIntDef(Str: String; Default: Integer) Integer#

Функция возвращает целочисленное значение строки Str, выполняя приведение типа. Если функция не может выполнить приведение типа, то возвращает значение параметра Default.

Parameters
  • Str (String) – Строка.

  • Default (Integer) – Значение по умолчанию.

Return type

Integer

StrToInt(Str: String) Integer#

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

Parameters

Str (String) – Входная строка.

Return type

Integer

StrToFloat(Str: Variant) Float#

Функция преобразует строку Str в число с плавающей запятой.

Parameters

Str (Variant) – Входная строка.

Return type

Float

StrToDouble(Str: String) Double#

Функция преобразует строку Str в число с плавающей запятой.

Parameters

Str (String) – Входная строка.

Return type

Double

StrToDateFmt(Value, FmtString: String) Variant#

Преобразует строку Value в значение типа дата, согласно строке форматирования FmtString.

Parameters
  • Value (String) – Входная строка.

  • FmtString (String) – Строка форматирования.

Return type

Variant

StrToDateTimeFmt(Value, FmtString: String) TDateTime#

Преобразует строку Value в значение типа дата-время, согласно строке форматирования FmtString.

Parameters
  • Value (String) – Входная строка.

  • FmtString (String) –

    Строка форматирования.

    Note

    Особенности строки форматирования для метода StrToDateTimeFmt: Строка должна содержать как строку формата даты так и формата времени, разделённых пробелом. То, что до пробела будет считаться форматом даты, после пробела форматом времени Разделитель даты (времени) может быть произвольным ( . , : ; / -). Разделителем считается первый символ в строке формата не являющийся числом или буквой. Пример: 'YYYY/MM/DD h-mm-ss' в данном случае разделителем даты будет “/”, а разделителем времени “-“.

Return type

TDateTime

Пример использования#
<pascal>
  ShowMessage(StrToDateFmt('2005-12-10', 'YYYY-MM-DD'));
  ShowMessage(StrToDateTimeFmt('2005/12/10 10-15-26', 'YYYY/MM/DD h-mm-ss'));
  ShowMessage(StrToTimeFmt('10.15.26', 'h.mm.ss'));
</pascal>
StrToTimeFmt(Value, FmtString: String) TDateTime#

Преобразует строку Value в значение типа время, согласно строке форматирования FmtString.

Parameters
  • Value (String) – Входная строка.

  • FmtString (String) – Строка форматирования.

Return type

TDateTime

StringToArray(Text: Variant; Delimiter: Char) Array#

Функция преобразует строку Text в одномерный массив

Parameters
  • Text (Variant) – Исходная строка.

  • Delimiter (Char) – Cимвол-разделитель.

Return type

Array

ArrayToString(Array: Array; Delimiter: String) String#

Функция преобразует одномерный массив Array в строку с разделителем Delimiter.

Parameters
  • Array (Array) – Исходный массив. Если в качестве параметра Array был передан не массив, то функция вернёт строковое представление переменной

  • Delimiter (String) – Символ-разделитель

Return type

String

IntToStr(Value: Integer) String#

Функция возвращает строку, выполняя приведение значения Value целочисленного типа к строке.

Parameters

Value (Integer) – Число.

Return type

String

IntToHex(Digits, Value: Integer) String#

Функция возвращает шестнадцатиричное представление в строку целочисленного числа Value.

Parameters
  • Digits (Integer) – Минимальное количество символов в шестнадцатиричном представлении.

  • Value (Integer) – Значение которое необходимо представить в шестнадцатиричном представлении.

Return type

String

FloatToStr(Value: Float) String#

Функция возвращает строку, выполняя приведение типа числа Value к строке.

Parameters

Value (Float) – Вещественное число.

Return type

String

FormatFloat(const Format: string; Value: Extended) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

TimeToStr(Time: TDateTime) String#

Функция преобразует время Time в строку и возвращает строковое значение.

Parameters

Time (TDateTime) – Значение времени.

Return type

String

DateTimeToStr(DateTime: TDateTime) String#

Функция преобразует значение даты-времени Time в строку и возвращает строковое значение.

Parameters

DateTime (TDateTime) – Значение даты-времени.

Return type

String

DateToStr(Date: TDateTime) String#

Функция возвращает строку, выполняя приведение типа даты Date к строке.

Parameters

Date (TDateTime) – Значение даты.

Return type

String

VarToStr(Variant: Variant) String#

Функция конвертирует значение Variant переменной в строку.

Parameters

Variant (Variant) – Переменная, значение которой должно быть преобразовано в строку

Return type

String

ConvertOemToAnsi(Text: String) String#

Преобразовывает текст в Oem кодировке в кодировку Ansi.

Parameters

Text (String) – Исходная строка.

Return type

String

Warning

Не реализовано

ConvertAnsiToOem(Text: String) String#

Преобразовывает текст в Ansi кодировке в кодировку Oem.

Parameters

Text (String) – Исходная строка.

Return type

String

Warning

Не реализовано

Length(Str: String) Integer#

Возвращает длину строки Str.

Parameters

Str (String) – Строка.

Return type

Integer

Pos(Substr, Str: String) Integer#

Функция возвращает индекс символа начала первого вхождения подстроки SubStr в строку Str. В случае если подстрока не найдена, функция возвращает 0.

Parameters
  • Substr (String) – Подстрока.

  • Str (String) – Строка.

Return type

Integer

Ord(S: Char) Integer#

Функция возвращает byte код ASCII символа S.

Parameters

S (Char) – ASCII символ.

Return type

Integer

TatStrUtilsLibrary#

Warning

Не поддерживается в Application Server

class TatStrUtilsLibrary#

Строковые функции

DecodeSoundexWord(AValue: Word) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

Warning

Не поддерживается в Application Server

PosEx(const SubStr, S: string; Offset: Integer) Integer#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiLeftStr(const Text: string; const Count: Integer) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiReverseString(const Text: string) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiStartsStr(const SubText, Text: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiContainsText(const Text, SubText: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiContainsStr(const Text, SubText: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

SoundexProc(const Text, Other: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

SoundexCompare(const Text, Other: string; Length: TSoundexLength) Integer#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

SoundexSimilar(const Text, Other: string; Length: TSoundexLength) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

SoundexWord(const Text: string) Word#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

DecodeSoundexInt(Value: Integer) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

SoundexInt(const Text: string; Length: TSoundexIntLength) Integer#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

Soundex(const Text: string; Length: TSoundexLength) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

SearchBuf(Buf: PAnsiChar; BufLen: Integer; SelStart, SelLength: Integer; SearchString: AnsiString; Options: TStringSearchOptions) PAnsiChar#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiMidStr(const Text: string; const Start, Count: Integer) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiRightStr(const Text: string; const Count: Integer) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

MidBStr(const Text: AnsiString; const ByteStart, ByteCount: Integer) AnsiString#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

RightBStr(const Text: AnsiString; const ByteCount: Integer) AnsiString#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

LeftBStr(const Text: AnsiString; const ByteCount: Integer) AnsiString#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

StuffString(const Text: string; Start, Length: Cardinal; const AubText: string) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

ReverseString(const Text: string) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

DupeString(const Text: string; Count: Integer) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiReplaceStr(const Text, FromText, ToText: string) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiEndsStr(const SubText, Text: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiReplaceText(const Text, FromText, ToText: string) string#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiEndsText(const SubText, Text: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiStartsText(const SubText, Text: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

AnsiResemblesText(const Text, Other: string) Boolean#

Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

class TSoundexLength#

Встроенный тип. Описание на Embarcadero docwiki

TStringList#

class TStringList#

Объект для работы со строками. Для его использования необходимо подключить (с помощью директивы “uses”) модуль Classes

Встроенный тип. Описание на Embarcadero docwiki