7.3.2. Нуль-терминальные строки

Нуль-терминальные строки широко используются при обращениях к так называемым API-функциям Windows (API - Application Program Interface - интерфейс прикладных программ). Поскольку компоненты Delphi берут на себя все проблемы связи с API-функциями Windows, программисту редко приходится прибегать к нуль-терминальным строкам. Тем не менее в этом разделе описываются особенности обработки таких строк.

Прежде всего напомню, что базовый тип string хранит в памяти терминальный нуль, поэтому Object Pascal допускает смешение обоих типов в одном строковом выражении, а также реализует взаимное приведение типов с помощью автофункций преобразования String и PChar. Например:

procedure TfmExample.FormActivate(Sender: TObject);

var

pcS: PChar;

ssS: String;

begin

pcS := '123456';

ssS := 'X = ';

IbOutput.Caption := ssS + pcS;

end;

В строке IbOutput будет выведено х = 123456. Другой пример. В состав API-функцией входят функция MessageBox, с помощью которой на экране создается диалоговое окно с заголовком, текстовым сообщением и набором кнопок. Если в конце предыдущего примера добавить оператор

MessageBox(0, ssS + pcS, 'Заголовок окна', mb_0k);

то компилятор укажет на ошибку, т. к. вторым параметром обращения к функции должно быть выражение типа PChar, в то время как выражение sss+pcs приводится компилятором к общему типу String. Правильным будет такое обращение:

MessageBox(0, PChar (ssS + pcS), 'Заголовок окна', mb_0k) ;

Текстовые константы совместимы с любым строковым типом, поэтому третий параметр обращения (он тоже должен быть типа PChar) компилятор обработает без ошибок.

В Delphi считается совместимым с pchar и string массив символов с нулевой нижней границей. В отличие от pchar и String такой массив распределяется статически (на этапе компиляции), поэтому наполнение массива символами и завершающим нулем осуществляется специальной процедурой Strcopy:

procedure TfmExample.bbRunClick(Sender:TObject);

var

acS: array [0..6] of Char;

begin

StrCopy(acS, '123456');

IbOutput.Caption := acS;

end;

Для работы с типом pchar используются такие же операции, как и с типом String: операция конкатенации “+” и операции сравнения >, >=, <, <=, =, <>.

Таблица 7.13. Подпрограммы для работы с нуль-терминальными строками

Function CharToOem (Str, OemStr: PChar): Bool; | Преобразует символы строки Str из кодировки ANSI в кодировку MS-DOS и помещает результат в OemStr.Всегда возвращает True
Function CharToOemBuff(Str, OemStr: PChar; MaxLen: Lorigint): Bool; | Преобразует не более MaxLen символов строки Str из кодировки ANSI в кодировку MS-DOS и помещает результат в OemStr. Всегда возвращает True
Function OemToChar (OEMStr, Str: PChar): Bool; | Преобразует символы из кодировки MS-DOS в кодировку ANSI и возвращает True
Function OemToCharBuff(OEMStr, Str: PChar;MaxLen: Longint): Bool; | Преобразует не более MaxLen символов строки OemStr из кодировки MS-DOS в кодировку ANSI и помещает результат в Str. Всегда возвращает True
Function StrCat(Dest,Source: PChar): PChar; | Копирует строку Source в конец строки Dest и возвращает указатель на строку Dest
Function StrComp (Strl,Str2: PChar): Integers; | Побайтно сравнивает строку Strl со строкой Str2 и возвращает следующий результат: =0 для Strl=Str2; >0 для Strl>Str2,- 0 для Strl<Str2
Function StrCopy(Dest,Source: PChar): PChar; | Копирует строку Source в строку Dest и возвращает указатель на Dest. StrCopy не проверяет реальный размер памяти, связанный с Dest (он должен быть не меньше StrLen(Source)+1)
Procedure StrDispose(Str: PChar) ; | Удаляет строку Str из памяти. Строка должна быть предварительно помещена в память функцией StrNew. Если Str=NlL, процедура ничего не делает
Function StrECopy(Dest, Source: PChar): PChar; | Объединяет строки. Эта функция работает в точности, как StrCat, но возвращает указатель на конец сцепленных строк, т. е. на терминальный ноль
Function StrEnd(Str: PChar): PChar; | Функция возвращает указатель на терминальный нольстроки Str
Function StrIComp(Strl,Str2: PChar): PChar; | Функция сравнивает строки, игнорируя возможную разницу в высоте букв. Возвращает такой же результат, как и StrComp. Замечу, что функция правильно работает лишь с латиницей. Для кириллицы ее нужно модифици ровать (см.ниже)

Function StrLCat(Dest,Source: PChar; MaxLen:Word): PChar; | Копирует символы строки Source в конец строки Dest до тех пор, пока не будут скопированы все символы или пока длина сцепленной строки Dest не достигнет MaxLen. Возвращает указатель на сцепленную строку. В отличие от StrCopy эта функция блокирует возможноепереполнение области памяти, связанной с Dest. Обычно в качестве MaxLen используется выражение SizeOf(Dest)-!
Function StrLComp(Dest, Source: PChar; MaxLen: Word): PChar; | В отличие от StrComp сравнивает не более MaxLen символов строк. Возвращаемый результат такой же, как и у StrComp
Function StrLCopy(Dest, Source: PChar; MaxLen: Word): PChar; | Копирует символы из строки Source в строку Dest до тех пор, пока не будет скопирована вся строка или пока не будет скопировано MaxLen символов. В отличие от StrCopy блокирует возможное переполнение области памяти, связанной с Dest. В качестве MaxLen обычно используется выражение SizeOf(Dest)-1
Function StrLen(Str:PChar): Cardinal; | Возвращает длину строки
Function StrLIComp(Strl, Str2: PChar; MaxLen: Word): PChar; | Сравнивает не более MaxLen символов строк, проверяя точное соответствие высоты букв. Возвращаемый результат см. StrComp. Функция правильно работает только с латиницей
Function StrLower(Str: PChar): PChar; | Преобразует заглавные буквы строки Str к строчным и возвращает указатель на результат. Функция правильно работает только с латиницей
Function S t rMove(Dest, Source: PChar; Count:Word): PChar; | Копирует точно Count символов строки Source в строку Dest и возвращает указатель на результат. Функция игнорирует действительные размеры строк и может выйти за их пределы
Function StrNew(Str:PChar): PChar; | Помещает строку в память
Function StrPas(Str:PChar): String; | Преобразует нуль-терминальную строку в строку String
Function StrPCopytStr: PChar; S: String):PChar; | Преобразует строку String в нуль-терминальную строку. Возвращает указатель на Str
Function StrPos(Strl, Str2: PChar): PChar; | Ищет подстроку Str2 в строке Strl и возвращает указатель на первое вхождение Str2 или MIL, если подстрока не найдена
Function StrRScan(Str: PChar; Ch: Char):PChar; | Ищет символ Ch в строке Str и возвращает указатель напоследний обнаруженный символ Ch или NIL, если символ не найден
Function StrScan(Str:PChar; Ch: Char):PChar; | Ищет символ Ch в строке Str и возвращает указатель на первый обнаруженный символ Ch или MIL, если символ не найден
Function StrUpper (Str: PChar) : PChar | Преобразует строчные буквы строки Str к заглавным и возвращает указатель на результат. Функция правильно работает только с латиницей

Функции преобразования из ANSI-кодировки в кодировку MS-DOS (charToxxx) и обратно (OеmTоххх) правильно работают с кириллицей, если в MS-DOS используется национальная страница 866 (так называемая альтернативная кодировка). А вот четыре функции, использующие преобразование высоты букв (strLower, StrUpper, Stricomp и StrLIComp), работают корректно только для букв латинского алфавита (латиницы). Для русских букв вместо обращения к этим функциям следует использовать стандартные функции AnsiLowerCase И AnsiUpperCase, которые используют как параметры String, так и PChar, но возвращают результат типа string:

var

acS: array [Byte] of Char;

begin

StrCopy(acS, 'заглавные буквы');

Caption := AnsiUpperCase(acS) end;

Аналогично для функции Stricomp:

var

apSl,apS2: array [0..1000] of Char;

begin

StrCopy(apSl,'эталон');

StrCopy(apS2,'ЭТАЛОН') ;

Caption := IntToStr(StrIComp(PChar(AnsiUpperCase(apSl)),

PChar(AnsiUpperCase(apS2))))

end;