`__crtLCMapStringW`

Článek
10/12/2023

Namapuje jeden znakový řetězec na jiný a provede zadanou transformaci závislá na národním prostředí. Tuto funkci lze také použít k vygenerování klíče řazení pro vstupní řetězec.

Syntaxe

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

Parametry

Locale
Identifikátor národního prostředí. Národní prostředí poskytuje kontext pro mapování řetězců nebo generování klíčů řazení. Aplikace může makro použít MAKELCID k vytvoření identifikátoru národního prostředí.

dwMapFlags
Typ transformace, která se má použít při mapování řetězců nebo generování klíče řazení.

lpSrcStr
Ukazatel na zdrojový řetězec, který funkce mapuje nebo používá ke generování klíčů řazení. Tento parametr se předpokládá jako řetězec Unicode.

cchSrc
Velikost v značce řetězce, na který lpSrcStr odkazuje parametr. Tento počet může obsahovat ukončovací znak null nebo ho nesmí obsahovat.

Hodnota cchSrc -1 určuje, že řetězec odkazovaný na lpSrcStr hodnotu null-terminated. Pokud ano, a tato funkce se používá v režimu mapování řetězců, funkce vypočítá samotnou délku řetězce a null-ukončí mapovaný řetězec uložený v *lpDestStr.

lpDestStr
Dlouhý ukazatel na vyrovnávací paměť, do které funkce ukládá mapovaný řetězec nebo klíč řazení.

cchDest
Velikost vyrovnávací paměti, na kterou lpDestStrodkazuje .

Vrácená hodnota

Pokud je hodnota nenulová cchDest , počet znaků nebo bajtů, pokud LCMAP_SORTKEY je zadán, zapisuje se do vyrovnávací paměti úspěch. Tento počet zahrnuje místo pro ukončovací znak null.

Pokud je hodnota cchDest nula, velikost vyrovnávací paměti ve znacích nebo bajty, pokud LCMAP_SORTKEY je zadána, vyžaduje přijetí přeloženého řetězce nebo klíče řazení značí úspěch. Tato velikost zahrnuje prostor pro ukončovací znak null.

Nula značí selhání. Pokud chcete získat rozšířené informace o chybě, zavolejte GetLastError funkci.

Poznámky

Pokud cchSrc je větší než nula a lpSrcStr je řetězec ukončený hodnotou null, __crtLCMapStringW nastaví cchSrc se na délku řetězce. Potom __crtLCMapStringW zavolá širokoúhlou verzi LCMapString funkce (Unicode) se zadanými parametry. Další informace o parametrech a návratové hodnotě této funkce naleznete v tématu LCMapString.

Požadavky

Rutina	Požadovaný hlavičkový soubor
`__crtLCMapStringW`	`<awint.h>`

Sdílet prostřednictvím