Манипулирование строками и преобразование наборов символов, страница 4

CharLowerBuff                         * Windows 98   + Windows 2000

Описание

Функция CharLowerBuff преобразует на месте символы из буфера в строчные буквы. При этом буфер может содержать нулевые символы. В данном случае также использует идентификатор текущей региональной установки.

Синтаксис

DWORD CharLowerBuff(LPTSTR IpszString, DWORD dwBytes)

Параметры

IpszString

LPTSTR: Указатель на буфер, содержимого которого подлежит преобразованию в строчные буквы.

dwBytes

DWORD: Количество байт в буфере.

Возвращаемое значение

DWORD: Количество байт в преобразованной части буфера.

Включаемый файл

winuser.h

См. также

CharLower, CharUpper, CharUpperBuff.

Пример

В приведенном ниже примере показано, как функции CharLowerBuff и CharUpperBuff работают с буферами, выполняя те же виды преобразований, что и функции CharUpper и CharLower. Функции CharLowerBuff и CharUpperBuff отличаются способностью выполнять преобразование только определенного числа символов и работать с буферами, в которых имеются пустые символы. Полученные результаты показаны на рис. 22.4.

См.    \local-eources\cbap22\22-02.txt

Идентификатор

Значение

1200

Код Unicode (формат BMP по стандарту ISO 10646)

1250

Восточно-европейская кодовая страница для Windows 3.1

1251

Кириллическая кодовая страница для Windows 3.1

1252

Кодовая страница США для Windows 3.1 (ANSI)

1253

Греческая кодовая страница для Windows 3.1

1254

Турецкая кодовая страница для Windows 3.1

1255

Еврейская кодовая страница

1256

Арабская кодовая страница

1257

Прибалтийская кодовая страница

1361

Корейская кодовая страница (Johab)

10000

Латинская кодовая страница для Macintosh

10001

Японская кодовая страница для Macintosh

10006

Первая греческая кодовая страница для Macintosh

10007

Кириллическая кодовая страница для Macintosh

10029

Вторая латинская кодовая страница для Macintosh

10079

Исландская кодовая страница для Macintosh

10081

Турецкая кодовая страница для Macintosh

CharPrev                                • Windows 98   • Windows 2000

Описание

Функция CharPrev возвращает указатель на предыдущий символ строки, уменьшая передаваемый адрес на ширину текущего символа.

Синтаксис

LPTSTR CharPrev (LPCTSTR IpszStartString, LPCTSTR IpszCurrentChar)

Параметры

IpszStartString

LPCTSTR: Указатель на первый символ в строке, завершающейся нулевым символом.

IpszCurrentChar

LPCTSTR: Указатель на текущий символ в строке. Если указываемый символ оказывается первым символом в строке, возврат из функции осуществляется без декремента.

Возвращаемое значение

LPTSTR: Если выполнение рассматриваемой функции окажется успешным, возвращается указатель на предыдущий символ. Если это начало строки, возвращается указатель на первый символ.

Включаемый файл

winuser.h

См. также

CharNext.

Пример

См. пример применения функции CharNext.

CharPrevExA                             • Windows 98   • Windows 2000

Описание

Функция CharPrevExA устанавливает указатель на предыдущий символ в строке, содержащей одно- или многобайтовые символы.

Синтаксис

LPTSTR CharPrevExA(WORD CodePage, LPCTSTR IpStart, LPCTSTR CurrentChar, DWORD dwfJags)

Параметры

CodePage

WORD: Идентификатор кодовой страницы, используемой для проверки пределов изменения начальных байтов. Этот параметр может принимать одно из значений кодовых страниц, перечисленных в табл. 22.2. Если же требуется использовать кодовую страницу ANSI по умолчанию, тогда следует установить значение 0 или СР_АСР этого параметра. Для использования кодовой страницы OEM по умолчанию достаточно установить значение СР_ОЕМСР данного параметра.

IpSlart

LPCTSTR: Указатель на начало строки.

IpCurrentChar

LPCTSTR: Указатель на символ в строке, завершающейся нулевым символом.

dwFlags

DWORD: Зарезервировано. Следует установить равным 0.

Возвращаемое значение

LPTSTR Если выполнение функции оказывается успешным, возвращается указатель на предыдущий символ в строке. Если же значение параметра IpCurrentChar равно IpStart, возвращается указатель на первый символ в строке.

Включаемый файл

winuser.h

См. также

CharNextExA, CharPrev.

CharToOem                             • Windows 98   • Windows 2000

Описание

Функция CharToOem преобразует строку из набора символов текущей региональной установки в набор символов OEM. Если символ присутствует в наборе символов OEM, он используется; в противном случае выбирается ближайший его эквивалент.

Синтаксис

BOOL CharToOem(LPCTSTR IpszSource, LPTSTR IpszDest)

Параметры

IpszSource

LPCTSTR: Указатель на строку, завершающуюся нулевым символом и представленную в текущем наборе символов.

IpszDest

LPTSTR: Указатель на буфер назначения, в который поступает строка, представленная в наборе символов OEM. Этот буфер может находиться по тому же адресу, что и исходная строка, определенная параметром IpszSource. В этом случае преобразование выполняется на месте. Однако если рассматриваемая функция применяется к широким символам, подобное преобразование оказывается невозможным.

Возвращаемое значение

BOOL: Функция всегда возвращает TRUE.

Включаемыйфайл

winuser.h

См. также

CharToOemBuff, OemToChar.

Пример

См. пример применения функции CharLower.

CharToOemBuff                        • Windows 98   • Windows 2000

Описание

Функция CharToOemBuff преобразует заданное количество символов в строке из набора символов текущей региональной установки в набор символов OEM. При этом символы, которые отсутствуют в наборе OEM (т.е.