StrToIntA 関数 (shlwapi.h)

  • [アーティクル]

10 進数の値を表す文字列を整数に変換します。 StrToLong マクロは、この関数と同じです。

構文

int StrToIntA(
  [in] PCSTR pszSrc
);

パラメーター

[in] pszSrc

種類: PCTSTR

変換する null で終わる文字列へのポインター。 10 進値を表す有効な文字列には 0 から 9 の文字のみが含まれており、正常に解析するには、次の形式が必要です。

(optional white space)(optional sign)(one or more decimal digits)

省略可能な記号には、文字 '-' または '+' を指定できます。省略した場合、符号は正であると見なされます。

戻り値

型: int

pszSrc で表される int 値を返します。 たとえば、文字列 "123" は整数値 123 を返します。

解説

pszSrc が指す文字列に無効な文字が含まれている場合、その文字は変換される文字列の末尾と見なされ、剰余は無視されます。 たとえば、無効な 10 進文字列 "12b34" を指定すると、 StrToInt は "12" のみを認識し、その整数値を返します。

注意

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlwapi.h
Library Shlwapi.lib
[DLL] Shlwapi.dll (バージョン 4.71 以降)

関連項目

StrToIntEx