次の方法で共有

__crtLCMapStringW

  • [アーティクル]

1 つの文字列を別の文字列にマップして、指定したロケールに依存する変換を実行します。 この関数を使用して入力文字列の並べ替えキーを生成することもできます。

構文

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

パラメーター

Locale
ロケール識別子です。 ロケールは、文字列のマッピングまたは並べ替えキーの生成のためのコンテキストを提供します。 アプリケーションは、 MAKELCID マクロを使用してロケール識別子を作成できます。

dwMapFlags
文字列のマッピングまたは並べ替えキーの生成時に使用する変換の種類。

lpSrcStr
関数によってマップされるソース文字列か、関数によって並べ替えキーの生成に使用されるソース文字列へのポインター。 このパラメーターでは、Unicode 文字列が想定されます。

cchSrc
lpSrcStr パラメーターによって示される文字列の文字のサイズ。 この数には、null 終端文字を含めることも除外することもできます。

cchSrc に値 -1 を設定した場合、lpSrcStr で指し示される文字列は null で終端します。 その場合、この関数が文字列マッピング モードで使用されている場合、関数は文字列の長さ自体を計算し、 *lpDestStrに格納されているマップされた文字列を null 終了します。

lpDestStr
マッピングされた文字列または並べ替えキーが関数によって格納されるバッファーへの long ポインター。

cchDest
lpDestStrで指し示されるバッファーのサイズ (文字単位)。

戻り値

cchDest の値が 0 以外の場合、バッファーに書き込まれた文字数 (または LCMAP_SORTKEY が指定された場合はバイト数) は成功を示します。 この数には、null 終端文字の分が含まれています。

cchDest の値が 0 の場合、翻訳された文字列または並べ替えキーを受け取るのに必要なバッファーのサイズ (文字数。 LCMAP_SORTKEY が指定された場合はバイト数) は成功を示します。 このサイズには、null 終端文字の分が含まれています。

0 は失敗を示します。 拡張されたエラー情報を取得するには、 GetLastError 関数を呼び出します。

解説

cchSrc が 0 より大きく、 lpSrcStr が null で終わる文字列の場合、 __crtLCMapStringW は cchSrc を文字列の長さに設定します。 次に、 __crtLCMapStringW は、 LCMapString のワイド文字列 (Unicode) バージョンを指定されたパラメーターで呼び出します。 この関数のパラメーターと戻り値の詳細については、 LCMapStringを参照してください。

要件

ルーチンによって返される値 必須ヘッダー
__crtLCMapStringW <awint.h>