Функции для работы с текстовыми строками
Для работы с текстовыми строками приложения Windows могут вызывать стандартные функции библиотеки компилятора, такие как strcat или strcopy. Однако лучше использовать функции для работы с текстовыми строками, определенные в программном интерфейсе Windows. Эти функции используют дальние указатели на строки и учитывают специфику национальных алфавитов. Кроме того, указанные функции находятся в ядре Windows, поэтому при их использовании не происходит увеличения размера файла загрузочного модуля приложения.
Функция lstrcmp сравнивает строки, заданные параметрами:
int WINAPI lstrcmp(LPCSTR lpszString1, LPCSTR lpszString2);
Функция возвращает отрицательное значение, если строка lpszString1 меньше чем строка lpszString2, положительное в противоположном случае, и равное нулю при равенстве сравниваемых строк. При сравнении учитываются особенности национального алфавита для указанной при помощи приложения Control Panel страны. Функция способна сравнивать строки с двухбайтовыми кодами символов. Учитываются также заглавные и прописные буквы. Размер сравниваемых строк не может превышать 64 Кбайт.
Функция lstrcmpi предназначена для сравнения двух строк, но без учета заглавных и прописных букв:
int WINAPI lstrcmpi(LPCSTR lpszString1, LPCSTR lpszString2);
В остальном она полностью аналогична функции lstrcmp.
Учтите, что известные вам функции strcmp и strcmpi не учитывают особенности национальных алфавитов и поэтому их не следует использовать в приложениях Windows.
Для копирования текстовых строк вы должны пользоваться функцией lstrcpy:
LPSTR WINAPI lstrcpy(LPSTR lpszString1, LPCSTR lpszString2);
Эта функция копирует строку lpszString2 в строку lpszString1, возвращая указатель на первую строку или NULL при ошибке. В отличие от своего аналога из библиотеки функций MS-DOS (функции strcpy) эта функция способна работать со строками, содержащими двухбайтовые коды символов. Размер копируемой строки не должен превышать 64 Кбайт.
В программном интерфейсе Windows версии 3.1 появилась еще одна функция, предназначенная для копирования заданного количества символов из одной строки в другую.
Эта функция имеет имя lstrcpyn:
LPSTR WINAPI lstrcpyn(LPSTR lpszString1, LPCSTR lpszString2, int cChars);
Она копирует cChars символов из строки lpszString2 в строку lpszString1.
Для объединения двух строк в приложениях Windows следует применять функцию lstrcat:
LPSTR WINAPI lstrcat(LPSTR lpszString1, LPCSTR lpszString2);
Функция lstrcat добавляет строку lpszString2 к строке lpszString1. Размер строки, получившейся в результате объединения, не должен превышать 64 Кбайт. Функция возвращает указатель на строку lpszString1.
Длину текстовой строки (без учета закрывающего строку двоичного нуля) можно получить при помощи функции lstrlen, аналогичной известной вам функции strlen:
int WINAPI lstrlen(LPCSTR lpszString);
Для классификации символов на строчные, прописные, буквенные или цифровые приложения должны использовать специально предназначенные для этого функции из программного интерфейса Windows.
Функция IsCharAlpha возвращает значение TRUE, если символ, заданный параметром chTest, является буквой:
BOOL WINAPI IsCharAlpha(char chTest);
Функция IsCharAlphaNumeric возвращает значение TRUE, если символ, заданный параметром chTest, является буквой или цифрой:
BOOL WINAPI IsCharAlphaNumeric(char chTest);
Функция IsCharUpper возвращает значение TRUE, если символ, заданный параметром chTest, является прописным (заглавным):
BOOL WINAPI IsCharUpper(char chTest);
Функция IsCharLower возвращает значение TRUE, если символ, заданный параметром chTest, является строчным:
BOOL WINAPI IsCharLower(char chTest);
В предыдущем томе "Библиотеки системного программиста" мы рассказывали вам о том, что Windows и MS-DOS используют разные наборы символов. Приложения Windows обычно работают с наборами в стандарте ANSI, программы MS-DOS - в стандарте OEM. Там же мы описали функции, предназначенные для преобразования строк из одного стандарта в другой. Для удобства изучения материала кратко перечислим эти функции еще раз.
Для перекодировки строки символов, закрытой двоичным нулем, из набора ANSI в набор OEM предназначена функция AnsiToOem:
void WINAPI AnsiToOem( const char _huge* hpszWindowsStr, char _huge* hpszOemStr);
Параметр hpszWindowsStr представляет собой указатель типа _huge на преобразуемую строку, параметр hpszOemStr - указатель на буфер для записи результата преобразования.
Похожая по назначению функция AnsiToOemBuff выполняет преобразование массива заданного размера:
void WINAPI AnsiToOemBuff(LPCSTR lpszWindowsStr, LPSTR lpszOemStr, UINT cbWindowsStr);
Первый параметр этой функции (lpszWindowsStr) является дальним указателем на массив, содержащий преобразуемые данные, второй (lpszOemStr) - на буфер для записи результата. Третий параметр (cbWindowsStr) определяет размер входного массива, причем нулевой размер соответствует 64 Кбайт (65536 байт).
Обратное преобразование выполняется функциями OemToAnsi и OemToAnsiBuff:
void WINAPI OemToAnsi(const char _huge* hpszOemStr, char _huge* lpszWindowsStr); void WINAPI OemToAnsiBuff(LPCSTR lpszOemStr, LPSTR lpszWindowsStr, UINT cbOemStr);
Назначение параметров этих функций аналогично назначению параметров функций AnsiToOem и AnsiToOemBuff.
Для преобразований символов в строчные или прописные приложение Windows должно пользоваться функциями AnsiLower, AnsiLowerBuff, AnsiUpper, AnsiUpperBuff.
Функция AnsiLower преобразует закрытую двоичным нулем текстовую строку в строчные (маленькие) буквы:
LPSTR WINAPI AnsiLower(LPSTR lpszString);
Единственный параметр функции - дальний указатель на преобразуемую строку.
Функция AnsiUpper преобразует закрытую двоичным нулем текстовую строку в прописные (большие) буквы:
LPSTR WINAPI AnsiLower(LPSTR lpszString);
Параметр функции lpszString - дальний указатель на преобразуемую строку.
Функция AnsiLowerBuff позволяет преобразовать в строчные (маленькие) буквы заданное количество символов:
UINT WINAPI AnsiLowerBuff(LPSTR lpszString, UINT cbString);
Первый параметр функции (lpszString) является указателем на буфер, содержащий преобразуемые символы, второй (cbString) определяет количество преобразуемых символов (размер буфера).
Нулевой размер соответствует буферу длиной 64 Кбайт (65536 байт).
Функция возвращает количество преобразованных символов.
Функция AnsiUpperBuff позволяет преобразовать в прописные (большие) буквы заданное количество символов:
UINT WINAPI AnsiUpperBuff(LPSTR lpszString, UINT cbString);
Первый параметр функции lpszString(lpszString) является указателем на буфер, содержащий преобразуемые символы, второй (cbString) определяет количество преобразуемых символов (размер буфера). Нулевой размер соответствует буферу длиной 64 Кбайт (65536 байт).
Эта функция, как и предыдущая, возвращает количество преобразованных символов.
Функция AnsiNext возвращает новое значение для указателя, передвинутое вперед по строке на одни символ:
LPSTR WINAPI AnsiNext(LPCSTR lpchCurrentChar);
Параметр функции указывает на текущий символ. Возвращаемое значение является указателем на следующий символ в строке или на закрывающий строку двоичный ноль.
Функция AnsiPrev выполняет передвижение указателя в направлении к началу строки:
LPSTR WINAPI AnsiPrev(LPCSTR lpchStart, LPCSTR lpchCurrentChar);
Первый параметр функции указывает на начало строки (на первый символ строки). Второй параметр - указатель на текущий символ. Функция возвращает значение указателя, соответствующее предыдущему символу или первому символу в строке, если при продвижении достигнуто начало строки.
