CharNextA 関数 (winuser.h)

  • [アーティクル]

文字列内の次の文字へのポインターを取得します。 この関数は、1 バイト文字またはマルチバイト文字で構成される文字列を処理できます。

構文

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

パラメーター

[in] lpsz

型: LPCTSTR

null で終わる文字列内の文字。

戻り値

種類: LPTSTR

戻り値は、文字列内の次の文字へのポインター、または文字列の末尾にある場合は終端の null 文字へのポインターです。

lpsz が終端の null 文字を指している場合、戻り値は lpsz と等しくなります。

注釈

ANSI 関数として呼び出されると、 CharNext はシステムの既定のコード ページを使用しますが、 CharNextExA は使用するコード ページを指定します。

この関数は、分音記号を扱うときの文字の既定の "ユーザー" の期待に対応します。 たとえば、U+0061 U+030a "LATIN SMALL LETTER A" + COMBINING RING ABOVE" を含む文字列は、"å" のように見えますが、1 つではなく 2 つのコード ポイントを進めます。 U+0061 U+0301 U+0302 U+0303 U+0304 を含む文字列は、"a'^~ ̄" のように見えますが、1 つではなく 5 つのコード ポイントを進めます。

注意

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CharNext を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

こちらもご覧ください

CharNextExA

CharPrev

概念

リファレンス

文字列