2.6. Строки¶

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

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. Число с плавающей точкой. Значение конвертируется в строку, представляющую валюту. Конвертирование контролиреутся глобальными переменными CurrencyString, CurrencyFormat, NegCurrFormat, ThousandSeparator, DecimalSeparator, CurrencyDecimals или их эквивалентами в структуре TFormatSettings. Если указан спецификатор точномти, то его значение перкрывает значение переменной CurrencyDecimals или ее эквивалента в структуре TFormatSettings.

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

s
String. Символ (буква), строка или указатель на строку (PChar). Строка или символ вставляется на место спецификатора формата.
Args (Array) – Массив аргументов.

Return type:

String

Пример использования¶

<pascal>
  Format('%*.*f', [8, 2, 123.456]);
  // is equivalent to
  Format('%8.2f', [123.456]);
</pascal>

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

ConvertAnsiToOem(Text: String): String¶

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

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

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

2.6.1. TatStrUtilsLibrary¶

class TatStrUtilsLibrary¶

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

DecodeSoundexWord(AValue: Word): string;¶: Метод из стандартной библиотеки Pascal. Описание на Embarcadero docwiki

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

2.6.2. TStringList¶

class TStringList¶

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

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