Работа со строками на winAPI в delphi.

Добавляет Str в таблицу атомов. Для каждого уникального строкового экземпляра ведется счетчик ссылок.

function AddAtom(Str: PChar): TAtom;
Параметры:
Str: Символьная строка, заканчивающаяся пустым символом.
Возвращаемое значение: В случае успешного завершения - уникальный идентификатор атома; в противном случае, -1.

Использует драйвер языка для преобразования Str в нижний регистp.

function AnsiLower(Str: PChar): PChar;
Параметры:
Str: Строка, заканчивающаяся пустым символом, или одиночный символ (в младшем байте).
Возвращаемое значение: Преобразованная строка или символ.

Использует драйвер языка для преобразования Str в нижний регистp.

function AnsiLowerBuff(Str: PChar, Length: Word): Word;
Параметры:
Str: Буфер символов.
Length: Длина символов в буфере; если нуль, то длина составляет 64К (65 536 байт).
Возвращаемое значение: Длина преобразованной строки.

Используется для итерации по строкам, символы которых имеют длину два или более байт.

function AnsiNext(CurrentChar: PChar): PChar;
Параметры:
CurrentChar: Строка, заканчивающаяся пустым символом.
Возвращаемое значение: Указатель на следующий символ в строке.

Используется для итерации в обратном направлении по строкам, символы которых имеют длину два или более байт.

function AnsiPrev(Start, CurrentChar: PChar): PChar;
Параметры:
Start: Начало строки (заканчивающейся пустым символом).
CurrentChar: Строка, заканчивающаяся пустым символом.
Возвращаемое значение: Указатель на предыдущий символ в строке.

Транслирует AnsiStr в символьный набор, определенный OEM. Длина может быть больше 64К.

function AnsiToOEM(AnsiStr, OemStr: PChar): Integer;
Параметры:
AnsiStr: Cтрока (заканчивающаяся пустым символом) символов ANSI.
OEMStr: Место, куда копируется отранслированная строка, может совпадать с AnsiStr.
Возвращаемое значение: Всегда -1.

Транслирует AnsiStr в символьный набор, определенный OEM.

function AnsiToOEMBuff(AnsiStr, OemStr: PChar Length: Integer);
Параметры:
AnsiStr: Буфер символов ANSI.
OEMStr: Место, куда копируется отранслированная строка, может совпадать с AnsiStr.
Length: Размер AnsiStr; если нуль, длина равна 64К.

Использует драйвер языка для преобразования Str в верхний регистp.

function AnsiUpper(Str: PChar): PChar;
Параметры:
Str: Строка, заканчивающаяся пустым символом или один символ (в младшем байте).
Возвращаемое значение: Преобразованная строка или символ.

Использует драйвер языка для преобразования Str в верхний регистp.

function AnsiUpperBuff(Str: PChar; Length: Word): Word;
Параметры:
Str: Буфер символов.
Length:Размер Str; если нуль, то длина равна 64К.
Возвращаемое значение: Длина преобразованной строки.

Записывает строку, используя текущий выбранный шрифт, внутри Rect.

function ExtTextOut(DC: HDC, X, Y: Integer; Options: Word; Rect: LPRect; Str: PChar; Count: Word; Dx: LPInteger): Bool;
Параметры:
DC: Идентификатор контекста устройства.
X, Y: Начало ячейки первого символа.
Options: Может быть комбинацией eto_Clipped и eto_Opaque. ARect: TRect или nil.
Str: Записываемая строка.
Count: Число символов в строке.
Dx: Массив значений, определяющих расстояния между соседними ячейками, или 0 в случае стандартного расстояния.
Возвращаемое значение: Не нуль, если строка нарисована; нуль - если нет.

Находит строку, соответствующую указанному атому.

function GetAtomHandle(AnAtom: TAtom): THandle;
Параметры:
AnAtom: Идентификатор атома.
Возвращаемое значение: Описатель строки атома в локальной памяти; 0 - если атом не существует.

Копирует связанную строку атома в Buffer.

function GetAtomName(AnAtom: TAtom, Buffer: PChar; Size: Integer): Word;
Параметры:
AnAtom: Идентификатор атома.
Buffer: Буфер для приема строки атома.
Size: Размер буфера в байтах.
Возвращаемое значение: Число байт, скопированных в Buffer; 0 - если указан неверный атом.

Использует языковый драйвер и текущий язык для определения того, является ли Alpha буквенным.

function IsCharAlpha(AChar: Char): Bool;
Параметры:
AChar: Проверяемый символ.
Возвращаемое значение: Не нуль, если символ буквенный; 0 - в противном случае.

Использует языковый драйвер и текущий язык для определения того, является ли Alpha алфавитно-цифровым .

function IsCharAlphaNumeric(AChar: Char): Bool;
Параметры:
AChar: Проверяемый символ.
Возвращаемое значение: Не нуль, если символ алфавитно-цифровой; 0 - в противном случае.

Использует языковый драйвер и текущий язык для определения того, является ли Alpha символом нижнего регистра.

function IsCharLower(AChar: Char): Bool;
Параметры:
AChar: Проверяемый символ.
Возвращаемое значение: Не нуль, если символ нижнего регистра; 0 - в противном случае.

Использует языковый драйвер и текущий язык для определения того, является ли Alpha символом верхнего регистра.

function IsCharUpper(AChar: Char): Bool;
Параметры:
AChar: Проверяемый символ.
Возвращаемое значение: Не нуль, если символ верхнего регистра; 0 - в противном случае.

Сцепляет Str1 с Str2.

function lstrcat(Str1, Str2: PChar): PChar;
Параметры:
Str1: Первая строка (заканчивающаяся пустым символом).
Str2: Вторая строка (заканчивающаяся пустым символом).
Возвращаемое значение: В случае успешного завершения - Str1; 0 - в противном случае.

Выполянет лексикографическое сравнение двух строк с учетом их регистра, базирующееся на текущем выбранном языке. Символы верхнего регистра сравниваются медленнее, чем символы нижнего регистра.

function lstrcmp(Str1, Str2: PChar): PChar;
Параметры:
Str1: Первая строка (заканчивающаяся пустым символом).
Str2: Вторая строка (заканчивающаяся пустым символом).
Возвращаемое значение: Меньше нуля, если Str1 < Str2; нуль, если Str1 = Str2; больше нуля, Str1 > Str2.

Выполянет лексикографическое сравнение двух строк без учета их регистра, базирующееся на текущем выбранном языке.

function lstrcmpi(Str1, Str2: PChar): PChar;
Параметры:
Str1: Первая строка (заканчивающаяся пустым символом).
Str2: Вторая строка (заканчивающаяся пустым символом).
Возвращаемое значение: Меньше нуля, если Str1 < Str2; нуль, если Str1 = Str2; больше нуля, Str1 > Str2.

Копирует Str2 (включая пустой символ) в Str1.

function lstrcpy(Str1, Str2: PChar): PChar;
Параметры:
Str1: Первая строка (заканчивающаяся пустым символом).
Str2: Вторая строка (заканчивающаяся пустым символом).
Возвращаемое значение: В случае успешного завершения - указатель на Str1; 0 - в противном случае.

Вычисляет длину (не включая пустой символ) строки Str.

function lstrlen(Str: PChar): Integer;
Параметры:
Str: Строка (заканчивающаяся пустым символом).
Возвращаемое значение: Длина Str в байтах.

К оглавлению