StrToInt64ExA 関数 (shlwapi.h)

10 進数または 16 進数の値を表す文字列を 64 ビット整数に変換します。

構文

BOOL StrToInt64ExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

パラメーター

[in] pszString

型: PCTSTR

変換する -terminated 文字列null へのポインター。 文字列の有効な形式の詳細については、「解説」セクションを参照してください。

dwFlags

型: STIF_FLAGS

pszString 64 ビット整数への変換の解析方法を指定する次のいずれかの値。

STIF_DEFAULT

pszString の文字列には、10 進値の表現が含まれています。

STIF_SUPPORT_HEX

pszString の文字列には、10 進数または 16 進数の値の表現が含まれています。 16 進数表現では、文字 A から F は大文字と小文字が区別されません。

[out] pllRet

型: LONGLONG*

変換された文字列の 64 ビット整数値を受け取る LONGLONG 型の変数へのポインター。 たとえば、文字列 "123" の場合、この値が指す整数は値 123 を受け取ります。

この関数が FALSE返す場合、この値は未定義です。

返される値が大きすぎて LONGLONG型の変数 含めなければ、このパラメーターには値の下位 64 ビットが含まれます。 それ以降の上位ビットはすべて失われます。

戻り値

型: BOOL

文字列が変換 場合は TRUE を返します。それ以外の場合は、FALSEを します。

備考

pszString パラメーターが指す文字列は、正常に解析するには、次のいずれかの形式である必要があります。

• このフォームは、いずれかのフラグの下に 10 進値として受け入れられます。 ''' 構文 (省略可能な空白)(省略可能な記号)(1 桁以上の 10 進数) '''
• これらの形式は、STIF_SUPPORT_HEX フラグが渡されるときに 16 進数の値に必要です。 ''' 構文 (省略可能な空白)(省略可能な記号)0x(1 桁以上の 16 進数) '''

  (optional white space)(optional sign)0X(one or more hexadecimal digits)
  

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

メモ 値が 16 進数として解析される場合、省略可能な記号は無視されます ('-' 文字であっても)。 たとえば、文字列 "-0x1" は -1 ではなく 1 として解析されます。

 

pszString 指す文字列に無効な文字が含まれている場合、その文字は変換される文字列の末尾と見なされ、残りは無視されます。 たとえば、無効な 16 進数文字列 "0x00am123" を指定すると、StrToInt64Ex は "0x00a" のみを認識し、それを整数値 10 に変換し、TRUE返します。

pllRet が NULL場合、この関数は、変換 を実行しない場合でも、文字列を変換できる場合は TRUE を返します。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shlwapi.h
ライブラリ	Shlwapi.lib
DLL	Shlwapi.dll (バージョン 5.0 以降)