`__crtLCMapStringW`

Статья
04/03/2023

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

Синтаксис

int __crtLCMapStringW(
   LCID    Locale,
   DWORD   dwMapFlags,
   LPCWSTR lpSrcStr,
   int     cchSrc,
   LPWSTR  lpDestStr,
   int     cchDest)

Параметры

Locale
Код локали. Языковой стандарт предоставляет контекст для сопоставления строк или создания ключа сортировки. Приложение может использовать макрос MAKELCID для создания идентификатора языкового стандарта.

dwMapFlags
Тип преобразования, который будет использоваться при сопоставлении строк или создании ключа сортировки.

lpSrcStr
Указатель на исходную строку, которая используется функцией для сопоставления или создания ключа сортировки. Предполагается, что этот параметр будет строкой в Юникоде.

cchSrc
Размер (в символах) строки, на которую указывает параметр lpSrcStr . Это число может содержать или не содержать символ конца строки NULL.

Значение cchSrc, равное –1, означает, что строка, на которую указывает параметр lpSrcStr, оканчивается нуль-символом. Если да, и эта функция используется в режиме сопоставления строк, функция вычисляет сам длину строки и завершает сопоставленную строку *lpDestStrв.

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

cchDest
Размер, в символах, буфера, на который указывает параметр lpDestStr.

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

Если значение cchDest отлично от нуля, число символов (или байтов, если указан LCMAP_SORTKEY ), записанных в буфер, указывает на успех. Это число включает место для символа конца строки NULL.

Если значение cchDest равно нулю, то размер буфера в символах (или байтах, если указан LCMAP_SORTKEY ), требуемый для получения преобразованной строки или ключа сортировки, указывает на успех. Этот размер включает место для символа конца строки NULL.

Нулевое значение означает сбой. Чтобы получить расширенные сведения об ошибке, следует вызвать функцию GetLastError .

Замечания

Если значение cchSrc больше нуля и параметр lpSrcStr представляет собой строку, завершающуюся нуль-символом, то функция __crtLCMapStringW устанавливает для параметра cchSrc значение, равное длине строки. Затем функция __crtLCMapStringW вызывает версию для расширенных символов (Юникод) функции LCMapString с указанными параметрами. Дополнительные сведения о параметрах и возвращаемых значениях этой функции см. в разделе LCMapString.

Требования

Маршрут	Обязательный заголовок
`__crtLCMapStringW`	`<awint.h>`

Поделиться через