На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

FoldString



The FoldString function maps one string to another, performing a specified transformation option.

int FoldString(

DWORD dwMapFlags, // mapping transformation options
LPCTSTR lpSrcStr, // pointer to source string
int cchSrc, // size of source string, in bytes or characters
LPTSTR lpDestStr, // pointer to destination buffer
int cchDest // size of destination buffer, in bytes or characters
);


Parameters

dwMapFlags

A set of bit flags that indicate the type of transformation to be used during mapping. This value can be a combination of the following bit-flag constants:

Option Meaning
MAP_FOLDCZONE Fold compatibility zone characters into standard Unicode equivalents. For information about compatibility zone characters, see the following Remarks section.
MAP_FOLDDIGITS Map all digits to Unicode characters 0 through 9.
MAP_PRECOMPOSED Map accented characters to precomposed characters, in which the accent and base character are combined into a single character value. This value cannot be combined with MAP_COMPOSITE.
MAP_COMPOSITE Map accented characters to composite characters, in which the accent and base character are represented by two character values. This value cannot be combined with MAP_PRECOMPOSED.


lpSrcStr

Points to the string to be mapped.

cchSrc

Specifies the size, in bytes (ANSI version) or characters (Unicode version), of the lpSrcStr buffer. If cchSrc is -1, lpSrcStr is assumed to be null-terminated, and the length is calculated automatically.

lpDestStr

Points to the buffer to store the mapped string.

cchDest

Specifies the size, in bytes (ANSI version) or characters (Unicode version), of the lpDestStr buffer. If cchDest is zero, the function returns the number of bytes or characters required to hold the mapped string, and the buffer pointed to by lpDestStr is not used.



Return Values

If the function succeeds, the return value is the number of bytes (ANSI version) or characters (Unicode version) written to the destination buffer, or if the cchDest parameter is zero, the number of bytes or characters required to hold the mapped string.
If the function fails, the return value is zero. To get extended error information, call GetLastError. GetLastError may return one of the following error codes:
ERROR_INSUFFICIENT_BUFFER
ERROR_INVALID_FLAGS
ERROR_INVALID_PARAMETER

Remarks

The mapped string is null-terminated if the source string is null-terminated.
The lpSrcStr and lpDestStr pointers must not be the same. If they are the same, the function fails and GetLastError returns ERROR_INVALID_PARAMETER.
The compatibility zone in Unicode consists of characters in the range 0xF900 through 0xFFEF that are assigned to characters from other character-encoding standards but are actually variants of characters that are already in Unicode. The compatibility zone is used to support round-trip mapping to these standards. Applications can use the MAP_FOLDCZONE flag to avoid supporting the duplication of characters in the compatibility zone.

See Also

LCMapString, CompareString


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

FoldString



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

int FoldString(

DWORD dwMapFlags, // ВЫБОРЫ преобразования распределения LPCTSTR lpSrcStr, // указатель в исходную строку int cchSrc, // размер исходной строки, в байтах или символах LPTSTR lpDestStr, // указателе в буфер расположения размера int cchDest // буфера расположения, в байтах или символах
);


Параметры

dwMapFlags

Набор бита сигнализирует, что указывает тип преобразования, которое нужно использоваться в течение распределения. Эта величина может быть комбинацией битового флага следующих констант:

Значение Выбора
MAP_FOLDCZONE Складывает символы зоны совместимости в стандартные эквиваленты Уникода. Для информации о символах зоны совместимости, смотри секцию Замечаний следующего.
MAP_FOLDDIGITS Отображает все цифры в символы Уникода 0 по 9.
Карта MAP_PRECOMPOSED акцентировала символы на precomposed символы, в которых акцент и базовый символ объединен в единственную символьную величину. Эта величина не может быть объединена MAP_COMPOSITE.
Карта MAP_COMPOSITE акцентировала символы в составные символы, в которых акцент и базовый символ представлен двумя символьными величинами. Эта величина не может быть объединена MAP_PRECOMPOSED.


lpSrcStr

Точки на строку, которые нужно отображаться.

cchSrc

Определяет размер, в байтах (версия ANSI) или символы (версия Уникода), буфера lpSrcStr. Если cchSrc - -1, lpSrcStr принят, чтобы быть недействительный расторгнутым, и длина вычисляется автоматически.

lpDestStr

Точки на буфер, чтобы загружать отображенную строку.

cchDest

Определяет размер, в байтах (версия ANSI) или символы (версия Уникода), буфера lpDestStr. Если cchDest - нуль, функция возвращает количество байтов или символов требовавшихся, чтобы держать отображенную строку, и буфер указывался, чтобы lpDestStr не использован.



Обратные Величины

Если функция добивается успеха, обратная величина - количество байтов (версия ANSI) или символы (версия Уникода) записанного в буфер расположения, или если параметр cchDest - нуль, количество байтов или символов требовавшиеся, чтобы держать отображенную строку.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError. GetLastError МОЖЕТ возвращать один из следующих кодов ошибки:
ERROR_INSUFFICIENT_BUFFER ERROR_INVALID_FLAGS ERROR_INVALID_PARAMETER

Замечания

Отображенная строка недействительный расторгнутая если исходная строка недействительный расторгнутая.
lpSrcStr И указатели lpDestStr не должны быть теми же. Если они - те же, функция терпит неудачу и возврат GetLastError ERROR_INVALID_PARAMETER.
Зона совместимости в Уникоде состоит из символов в дипазоне 0xF900 через 0xFFEF, которое назначено в символы из других символьных-кодирующих стандартов но - действительно вариантами символов, которые - уже в Уникоде. Зона совместимости использована, чтобы поддерживать распределение в оба конца в эти стандарты. Приложения могут использовать флаг MAP_FOLDCZONE, чтобы избегать поддерживать дублирование символов в зоне совместимости.

Смотри Также

LCMapString, CompareString


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz