「C言語/標準ライブラリ/inttypes.h」の版間の差分

履歴の双方向閲覧

← 古い編集次の差分 →

削除された内容追加された内容

ビジュアルウィキテキスト

インライン

2021年8月29日 (日) 23:40時点における版

float.h

C言語
inttypes.h

iso646.h

ヘッダー <inttypes.h> は、ヘッダー <stdint.h> をインクルードしホストされた実装によって提供される追加機能で <stdint.h> を拡張します^[1]。

<inttypes.h> では、最大幅の整数を操作する関数と数値文字列を最大幅の整数に変換する関数を宣言し、imaxdiv関数が返す値の型である構造体の型 imaxdiv_t を宣言しています。

<inttypes.h> では、宣言された各型には、フォーマットされた入出力関数で使用する変換指定子のための対応するマクロが定義されています。

フォーマット指定用マクロ

<inttypes.h> では、以下のフォーマット指定用マクロが定義されています^[2]。

以下のオブジェクトライクなマクロは、変換指定子を含む文字列リテラルに展開します。変換指定子を含む文字列リテラルに展開され、長さ修飾子によって修正されることもあります。これは、対応する整数型に変換する際に、フォーマットされた入出力関数の format 引数内で使用するのに適しています。

これらのマクロ名は、PRI (fprintf および fwprintf ファミリの文字列リテラル) または SCN (fscanf および fwscanf ファミリの文字列リテラル),220) の後に変換指定子が続き、その後に 7.20.1 の類似した型名に対応する名前が続くという一般的な形式をとる。これらの名前では、Nは§7.20.1 Integer types に記載されている型の幅を表す。例えば、PRIdFAST32 は、int_fast32_t型の整数の値を表示するためのフォーマット文字列として使用できる。

符号付き整数用のfprintfマクロ: PRIdN PRIdLEASTN PRIdFASTN PRIdMAX PRIdPTR; PRIiN PRIiLEASTN PRIiFASTN PRIiMAX PRIiPTR
符号なし整数用のfprintfマクロ: PRIoN PRIoLEASTN PRIoFASTN PRIoMAX PRIoPTR; PRIuN PRIuLEASTN PRIuFASTN PRIuMAX PRIuPTR; PRIxN PRIxLEASTN PRIxFASTN PRIxMAX PRIxPTR; PRIXN PRIXLEASTN PRIXFASTN PRIXMAX PRIXPTR
符号付き整数用のfscanfマクロ: SCNdN SCNdLEASTN SCNdFASTN SCNdMAX SCNdPTR; SCNiN SCNiLEASTN SCNiFASTN SCNiMAX SCNiPTR
符号なし整数用のfscanfマクロ: SCNoN SCNoLEASTN SCNoFASTN SCNoMAX SCNoPTR; SCNuN SCNuLEASTN SCNuFASTN SCNuMAX SCNuPTR; SCNxN SCNxLEASTN SCNxFASTN SCNxMAX SCNxPTR

（言語処理系は）実装が<stdint.h>で提供している各型について、対応するfprintfマクロを定義し、実装がその型に適したfscanf長さ修飾子を持たない限り、対応するfscanfマクロを定義しなければならない。

例

#include <stdio.h>
#include <inttypes.h>
int main(void)
{
  uintmax_t i = UINTMAX_MAX; // this type always exists
  wprintf(L"The largest integer value is %#022" PRIxMAX "\n", i);
  return 0;
}

実行結果

The largest integer value is 0x0000ffffffffffffffff

最大幅整数型のための関数

この節は書きかけです。この節を編集してくれる方を心からお待ちしています。

最大幅の整数を操作する関数^[3]

intmax_t imaxabs(intmax_t j);
imaxdiv_t imaxdiv(intmax_t numer, intmax_t denom);
intmax_t strtoimax(const char * restrict nptr, char ** restrict endptr, int base);
uintmax_t strtoumax(const char * restrict nptr, char ** restrict endptr, int base);
intmax_t wcstoimax(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);
uintmax_t wcstoumax(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);

具体的な値の例

<inttypes.h> で定義されているマクロの値（一例）
＼	*8	*16	*32	*64	*LEAST8	*LEAST16	*LEAST32	*LEAST64	*FAST8	*FAST16	*FAST32	*FAST64	*MAX	*PTR
PRId*	d	d	d	ld	d	d	d	ld	d	ld	ld	ld	ld	ld
PRIi*	i	i	i	li	i	i	i	li	i	li	li	li	li	li
PRIo*	o	o	o	lo	o	o	o	lo	o	lo	lo	lo	lo	lo
PRIu*	u	u	u	lu	u	u	u	lu	u	lu	lu	lu	lu	lu
PRIx*	x	x	x	lx	x	x	x	lx	x	lx	lx	lx	lx	lx
PRIX*	X	X	X	lX	X	X	X	lX	X	lX	lX	lX	lX	lX
SCNd*	hhd	hd	d	ld	hhd	hd	d	ld	hhd	ld	ld	ld	ld	ld
SCNi*	hhi	hi	i	li	hhi	hi	i	li	hhi	li	li	li	li	li
SCNo*	hho	ho	o	lo	hho	ho	o	lo	hho	lo	lo	lo	lo	lo
SCNu*	hhu	hu	u	lu	hhu	hu	u	lu	hhu	lu	lu	lu	lu	lu
SCNx*	hhx	hx	x	lx	hhx	hx	x	lx	hhx	lx	lx	lx	lx	lx

実際値を表示するプログラム

#include <stdio.h>
#include <inttypes.h>

int main(void) {
  puts("{| class='wikitable' style='text-align:center'");
  puts("|+ <inttypes.h> で定義されているマクロの値（一例）");
  puts("|-");
  puts("! ＼ !! *8 !! *16 !! *32 !! *64 !! *LEAST8 !! *LEAST16 !! *LEAST32 !! *LEAST64 !! *FAST8 !! *FAST16 !! *FAST32 !! *FAST64 !! *MAX !! *PTR");
  puts("|-");
  puts("! PRId*");
  puts("| " PRId8 " || " PRId16 " || " PRId32 " || " PRId64 " || " PRIdLEAST8 " || " PRIdLEAST16 " || " PRIdLEAST32 " || " PRIdLEAST64 " || " PRIdFAST8 " || " PRIdFAST16 " || " PRIdFAST32 " || " PRIdFAST64 " || " PRIdMAX " || " PRIdPTR "");
  puts("|-");
  puts("! PRIi*");
  puts("| " PRIi8 " || " PRIi16 " || " PRIi32 " || " PRIi64 " || " PRIiLEAST8 " || " PRIiLEAST16 " || " PRIiLEAST32 " || " PRIiLEAST64 " || " PRIiFAST8 " || " PRIiFAST16 " || " PRIiFAST32 " || " PRIiFAST64 " || " PRIiMAX " || " PRIiPTR "");
  puts("|-");
  puts("! PRIo*");
  puts("| " PRIo8 " || " PRIo16 " || " PRIo32 " || " PRIo64 " || " PRIoLEAST8 " || " PRIoLEAST16 " || " PRIoLEAST32 " || " PRIoLEAST64 " || " PRIoFAST8 " || " PRIoFAST16 " || " PRIoFAST32 " || " PRIoFAST64 " || " PRIoMAX " || " PRIoPTR "");
  puts("|-");
  puts("! PRIu*");
  puts("| " PRIu8 " || " PRIu16 " || " PRIu32 " || " PRIu64 " || " PRIuLEAST8 " || " PRIuLEAST16 " || " PRIuLEAST32 " || " PRIuLEAST64 " || " PRIuFAST8 " || " PRIuFAST16 " || " PRIuFAST32 " || " PRIuFAST64 " || " PRIuMAX " || " PRIuPTR "");
  puts("|-");
  puts("! PRIx*");
  puts("| " PRIx8 " || " PRIx16 " || " PRIx32 " || " PRIx64 " || " PRIxLEAST8 " || " PRIxLEAST16 " || " PRIxLEAST32 " || " PRIxLEAST64 " || " PRIxFAST8 " || " PRIxFAST16 " || " PRIxFAST32 " || " PRIxFAST64 " || " PRIxMAX " || " PRIxPTR "");
  puts("|-");
  puts("! PRIX*");
  puts("| " PRIX8 " || " PRIX16 " || " PRIX32 " || " PRIX64 " || " PRIXLEAST8 " || " PRIXLEAST16 " || " PRIXLEAST32 " || " PRIXLEAST64 " || " PRIXFAST8 " || " PRIXFAST16 " || " PRIXFAST32 " || " PRIXFAST64 " || " PRIXMAX " || " PRIXPTR "");
  puts("|-");
  puts("! SCNd*");
  puts("| " SCNd8 " || " SCNd16 " || " SCNd32 " || " SCNd64 " || " SCNdLEAST8 " || " SCNdLEAST16 " || " SCNdLEAST32 " || " SCNdLEAST64 " || " SCNdFAST8 " || " SCNdFAST16 " || " SCNdFAST32 " || " SCNdFAST64 " || " SCNdMAX " || " SCNdPTR "");
  puts("|-");
  puts("! SCNi*");
  puts("| " SCNi8 " || " SCNi16 " || " SCNi32 " || " SCNi64 " || " SCNiLEAST8 " || " SCNiLEAST16 " || " SCNiLEAST32 " || " SCNiLEAST64 " || " SCNiFAST8 " || " SCNiFAST16 " || " SCNiFAST32 " || " SCNiFAST64 " || " SCNiMAX " || " SCNiPTR "");
  puts("|-");
  puts("! SCNo*");
  puts("| " SCNo8 " || " SCNo16 " || " SCNo32 " || " SCNo64 " || " SCNoLEAST8 " || " SCNoLEAST16 " || " SCNoLEAST32 " || " SCNoLEAST64 " || " SCNoFAST8 " || " SCNoFAST16 " || " SCNoFAST32 " || " SCNoFAST64 " || " SCNoMAX " || " SCNoPTR "");
  puts("|-");
  puts("! SCNu*");
  puts("| " SCNu8 " || " SCNu16 " || " SCNu32 " || " SCNu64 " || " SCNuLEAST8 " || " SCNuLEAST16 " || " SCNuLEAST32 " || " SCNuLEAST64 " || " SCNuFAST8 " || " SCNuFAST16 " || " SCNuFAST32 " || " SCNuFAST64 " || " SCNuMAX " || " SCNuPTR "");
  puts("|-");
  puts("! SCNx*");
  puts("| " SCNx8 " || " SCNx16 " || " SCNx32 " || " SCNx64 " || " SCNxLEAST8 " || " SCNxLEAST16 " || " SCNxLEAST32 " || " SCNxLEAST64 " || " SCNxFAST8 " || " SCNxFAST16 " || " SCNxFAST32 " || " SCNxFAST64 " || " SCNxMAX " || " SCNxPTR "");
  puts("");
  puts("|}");
}

実行結果

{| class='wikitable' style='text-align:center'
|+ <inttypes.h> で定義されているマクロの値（一例）
|-
! ＼ !! *8 !! *16 !! *32 !! *64 !! *LEAST8 !! *LEAST16 !! *LEAST32 !! *LEAST64 !! *FAST8 !! *FAST16 !! *FAST32 !! *FAST64 !! *MAX !! *PTR
|-
! PRId*
| d || d || d || ld || d || d || d || ld || d || ld || ld || ld || ld || ld
|-
! PRIi*
| i || i || i || li || i || i || i || li || i || li || li || li || li || li
|-
! PRIo*
| o || o || o || lo || o || o || o || lo || o || lo || lo || lo || lo || lo
|-
! PRIu*
| u || u || u || lu || u || u || u || lu || u || lu || lu || lu || lu || lu
|-
! PRIx*
| x || x || x || lx || x || x || x || lx || x || lx || lx || lx || lx || lx
|-
! PRIX*
| X || X || X || lX || X || X || X || lX || X || lX || lX || lX || lX || lX
|-
! SCNd*
| hhd || hd || d || ld || hhd || hd || d || ld || hhd || ld || ld || ld || ld || ld
|-
! SCNi*
| hhi || hi || i || li || hhi || hi || i || li || hhi || li || li || li || li || li
|-
! SCNo*
| hho || ho || o || lo || hho || ho || o || lo || hho || lo || lo || lo || lo || lo
|-
! SCNu*
| hhu || hu || u || lu || hhu || hu || u || lu || hhu || lu || lu || lu || lu || lu
|-
! SCNx*
| hhx || hx || x || lx || hhx || hx || x || lx || hhx || lx || lx || lx || lx || lx

|}

参考

COLS = %w(8 16 32 64 LEAST8 LEAST16 LEAST32 LEAST64 FAST8 FAST16 FAST32 FAST64 MAX PTR)
ROWS = %w(PRId PRIi PRIo PRIu PRIx PRIX SCNd SCNi SCNo SCNu SCNx)

puts <<EOS
#include <stdio.h>
#include <inttypes.h>

int main(void) {
#{
(<<EOS1
{| class='wikitable' style='text-align:center'
|+ <inttypes.h> で定義されているマクロの値（一例）
|-
! ＼ !! #{COLS.map{|col| "*#{col}" }.join(" !! ")}
#{ ROWS.map{|row|
<<EOS2
|-
! #{row}*
| #{COLS.map{|col| %|" #{row}#{col} "| }.join(" || ")}
EOS2
}.join()
}
|}
EOS1
).split(/\n/).map{|line| %|  puts("#{line}");| }.join("\n")
}
}
EOS

歴史

<inttypes.h> は、ISO/IEC 9899:1999 (C99)で追加されました^[4]。

脚註

参考文献

国際標準化機構/国際電気標準会議 ISO/IEC 9899:2018(en) Information technology — Programming languages — C(2018-07-05)

[jtc1-sc22-wg14-n1570-7.8-1] C11: WG14/N1570 Committee Draft — April 12, 2011 ISO/IEC 9899:201x. ISO/IEC. p. 217, §7.8 Format conversion of integer types.

[jtc1-sc22-wg14-n1570-7.8.1-2] C11: WG14/N1570 Committee Draft — April 12, 2011 ISO/IEC 9899:201x. ISO/IEC. p. 217, §7.8.1 Macros for format specifiers.

[jtc1-sc22-wg14-n1570-7.8.2-3] C11: WG14/N1570 Committee Draft — April 12, 2011 ISO/IEC 9899:201x. ISO/IEC. p. 218, §7.8.2 Functions for greatest-width integer types.

[jtc1-sc22-wg14-n1570-foreword-4] C11: WG14/N1570 Committee Draft — April 12, 2011 ISO/IEC 9899:201x. ISO/IEC. p. xv, § Foreword ¶ Major changes in the second edition included:.

[1]

[2]

[3]

[4]