定義
#define	FILE struct __file
#define	stdin (__iob[0])
#define	stdout (__iob[1])
#define	stderr (__iob[2])
#define	EOF (-1)
#define	fdev_set_udata(stream, u) do { (stream)->udata = u; } while(0)
#define	fdev_get_udata(stream) ((stream)->udata)
#define	fdev_setup_stream(stream, put, get, rwflag)
#define	_FDEV_SETUP_READ __SRD
#define	_FDEV_SETUP_WRITE __SWR
#define	_FDEV_SETUP_RW (__SRD\|__SWR)
#define	_FDEV_ERR (-1)
#define	_FDEV_EOF (-2)
#define	FDEV_SETUP_STREAM(put, get, rwflag)
#define	fdev_close()
#define	putc(__c, __stream) fputc(__c, __stream)
#define	putchar(__c) fputc(__c, stdout)
#define	getc(__stream) fgetc(__stream)
#define	getchar() fgetc(stdin)
関数
int	fclose (FILE *__stream)
int	vfprintf (FILE __stream, const char __fmt, va_list __ap)
int	vfprintf_P (FILE __stream, const char __fmt, va_list __ap)
int	fputc (int __c, FILE *__stream)
int	printf (const char *__fmt,...)
int	printf_P (const char *__fmt,...)
int	vprintf (const char *__fmt, va_list __ap)
int	sprintf (char __s, const char __fmt,...)
int	sprintf_P (char __s, const char __fmt,...)
int	snprintf (char __s, size_t __n, const char __fmt,...)
int	snprintf_P (char __s, size_t __n, const char __fmt,...)
int	vsprintf (char __s, const char __fmt, va_list ap)
int	vsprintf_P (char __s, const char __fmt, va_list ap)
int	vsnprintf (char __s, size_t __n, const char __fmt, va_list ap)
int	vsnprintf_P (char __s, size_t __n, const char __fmt, va_list ap)
int	fprintf (FILE __stream, const char __fmt,...)
int	fprintf_P (FILE __stream, const char __fmt,...)
int	fputs (const char __str, FILE __stream)
int	fputs_P (const char __str, FILE __stream)
int	puts (const char *__str)
int	puts_P (const char *__str)
size_t	fwrite (const void __ptr, size_t __size, size_t __nmemb, FILE __stream)
int	fgetc (FILE *__stream)
int	ungetc (int __c, FILE *__stream)
char *	fgets (char __str, int __size, FILE __stream)
char *	gets (char *__str)
size_t	fread (void __ptr, size_t __size, size_t __nmemb, FILE __stream)
void	clearerr (FILE *__stream)
int	feof (FILE *__stream)
int	ferror (FILE *__stream)
int	vfscanf (FILE __stream, const char __fmt, va_list __ap)
int	vfscanf_P (FILE __stream, const char __fmt, va_list __ap)
int	fscanf (FILE __stream, const char __fmt,...)
int	fscanf_P (FILE __stream, const char __fmt,...)
int	scanf (const char *__fmt,...)
int	scanf_P (const char *__fmt,...)
int	vscanf (const char *__fmt, va_list __ap)
int	sscanf (const char __buf, const char __fmt,...)
int	sscanf_P (const char __buf, const char __fmt,...)
int	fflush (FILE *stream)
FILE *	fdevopen (int(put)(char, FILE ), int(get)(FILE ))

詳しい説明

 #include <stdio.h>

標準入出力への導入

このファイルは、avr-libcで実装されている標準入出力機能を示しています。ハードウェアの性質のため、標準入出力の限られたサブセットのみ実装されています。利用できる実際のファイル実装はなく、デバイスの入出力のみ実行できます。オペレーティングシステムがないので、アプリケーションは、標準入出力を使用するために、デバイスに関する十分な詳細を提供する必要があります。

メモリの制約のため、いくつかの機能は全く実装されていません（たとえば、いくつかのprintf変換は無視されています）。それでもこの実装の潜在的なユーザに警告しておきます： printfやscanf関連の関数は、有名な"Hello, world!"プログラムのようにおそらく単純なことだが、実際はかなり複雑で、かなりの量のコードスペースを消費する内容を含んでいる。また、実行時にフォーマット文字列を解釈するために速くないです。可能な限りavr-licにより提供される予め決められた（時々標準ではない）変換機能に頼ることで、通常スピードもコードサイズも少なくすることができます。

コードサイズ対機能のための調整できる選択肢

プログラマーにコードサイズと機能のトレードオフを与えるために、printf関数の核心部であるvfprintf()関数は、リンカオプションを使い異なった味付けが選ぶことができます。詳しい説明については、vfprintf()のドキュメントを参照してください。同じことがvfscanf()とscanf関数ファミリーにも適用されます。

選ばれたAPIの概要

標準ストリーム stdin、stdoutとstderrが提供されています。しかし、Cの標準に反して、avr-libcには適用できるデバイス情報がないため、これらのストリームはアプリケーション起動時にプレ初期化はされていません。また、avr-libcには全くファイルの概念がないため、いくつかのデバイスのストリームに関連づけて使用するfopen()関数がありません。(note 1参照) その代わりに、 fdevopen()関数がデバイスのストリームに関連づけるために提供されています。デバイスは、文字送信、文字受信、もしくはその両方の関数を提供している必要があります。avr-libcの中では、"テキスト"と"バイナリ"ストリームのを識別はありません。文字 \nは、文字通りデバイスのput()関数へ送信されます。もし、復改(\r)文字をラインフィードの前に送ることを要求するなら、put()ルーチンが実装しなければならない。(note 2参照)

fdevopen()への代替手法として、ユーザ提供のFILE構造を初期化して使うfdev_setup_stream()マクロがある。

改行文字の中に復改を入れる自動変換に注意してください。改行のこの手続きは、バイナリ転送を壊します。もし、バイナリ転送を望むならば、自動変換は実行してはいけません。その代わりに、CR-LFシーケンスを出す目的どんな文字列でもはっきりと"\r\n"を使わなければなりません。

便宜上, 最初に呼び出され、読出しストリームを開くfdevopen()の結果できたストリームをstdinにエイリアスします。同様に、最初に呼び出され、書込みストリームを開くfdevopen()の結果できたストリームをstdoutとstderrの両方にエイリアスします。そして、読み書きを意図して両方とも開いたのであれば、3つ全ての標準ストリームは同じとなります。これらのエイリアスは、互いに区別が付かないことを注意してください。そして、ストリームに対してfclose()を呼び出すと、全てのエイリアスを事実上閉じます。(note 3).

fdev_set_udata()を使うことで、ユーザデータをストリームに関連づけることができます。バックエンドのputとget関数は、 fdev_get_udata()を使うことでユーザデータを得ることができ、適切に振る舞いことが出来ます。例えば、1つのput関数で2つの異なるUARTと話すことや、putとget関数で呼出しの間で内部状態を保つことができます。

Flahs ROM内でのフォートマット文字列

全てのprintfとscanf関数関連は、2つの種類が用意されている。標準的な名前で、フォーマット文字列がSRAM上にあることになっています。もう一つは接尾辞に"_P"が付く版で、フォーマット文字列がFlash ROM上あることになっています。 PSTRマクロ（<avr/pgmspace.h>: プログラム空間ユーティリティで説明）は、これらのフォーマットストリングを非常に使いやすくします。

malloc()を使わず標準入出力を動かす

標準では、fdevopen()はmalloc()を要求します。これは、マイクロコントローラの限られた環境ではしばしば望まれません。代わりの選択肢としは、malloc()なしで完全に動作するために提供されています。

fdev_setup_stream()マクロは、標準入出力の動作のためのユーザー提供FILEバッファを準備するために提供されています。

例

    #include <stdio.h>

    static int uart_putchar(char c, FILE *stream);

    static FILE mystdout = FDEV_SETUP_STREAM(uart_putchar, NULL,
                                             _FDEV_SETUP_WRITE);

    static int
    uart_putchar(char c, FILE *stream)
    {

      if (c == '\n')
        uart_putchar('\r', stream);
      loop_until_bit_is_set(UCSRA, UDRE);
      UDR = c;
      return 0;
    }

    int
    main(void)
    {
      init_uart();
      stdout = &mystdout;
      printf("Hello, world!\n");

      return 0;
    }

この例は、関数のようなfdev_setup_stream()ではなく、FDEV_SETUP_STREAM()による初期化を使用しているため、全てのデータ初期化が、Cのスタートタップ中に行われます。

もし、そのように初期化されたストリームが、もう必要ないならば、fdev_close()マクロを最初に呼び出すことで破棄できて、オブジェクト自体を無効にします。fclose()の呼出しは、これらのストリームに対してはしてはいけません。fclose()を呼び出すことは無害とはいえ、free()の未定義参照を引き起こし、アプリケーションにmallocモジュールをリンクさせてしまう原因となります。

注釈

注釈1：: fopen()と互換性のあるデバイスの抽象化を実装することは可能だったかもしれないが、文字列解析や、文字列やアプリケーションから提供される追加のテーブルや情報を必要としたため、このようなアプローチは採用しませんでした。

注釈2：: これはUnixのアプローチに由来し：ターミナルのようなデバイスが、特別な処理を必要とするなら、この機能を提供するターミナルデバイスドライバの領域内となります。このように、UARTインターフェースに話すfdevopen()のために適した簡単な関数put()は、次のようになります。

    int
    uart_putchar(char c, FILE *stream)
    {

      if (c == '\n')
        uart_putchar('\r');
      loop_until_bit_is_set(UCSRA, UDRE);
      UDR = c;
      return 0;
    }

注釈 3:: エイリアスを維持するコストが、各ストリームのフルコピーを維持するよりもコストがかなり小さいため、この実装を選びました。それでも、標準ストリームの完全なセットを提供する実装を提供するは、役立つと考えられます。fprintf(mystream, ...)の代わりにprintf()と書くことで、タイピングを少なくするだけではなく、avr-gccが（固定数のパラメータを取る関数のためのレジスタにそれらを渡すのとは対照的に）スタック上の可変長引数関数の全ての引数の引き渡す必要があるため、stdinやstdoutを意味する1つのパラメータを少なく渡すことにより、若干の実行時間も節約します。

定義ドキュメント

#define _FDEV_EOF (-2)

デバイスの読込みにおけるEnd-of-File状態のリターンコード

fdevopen()のget関数で使用される。

#define _FDEV_ERR (-1)

デバイスの読込みにおけるエラー状態のリターンコード

fdevopen()のget関数で使用される。

#define _FDEV_SETUP_READ __SRD

fdev_setup_stream()での、読込み目的

#define _FDEV_SETUP_RW (__SRD|__SWR)

fdev_setup_stream()での、読み書き目的

#define _FDEV_SETUP_WRITE __SWR

fdev_setup_stream()での、書込み目的

#define EOF (-1)

EOFは、いろいろな標準入出力関数によるエラーの場合に返される値を宣言している。（現在の）AVRプラットフォームが、実際のファイルのための抽象概念を持たないため、ここでは、本来の"end of file"の意味があまりありません。

#define fdev_close ( )

このマクロは、streamと関係しているかも知れないライブラリリソースを開放します。ストリームが必要ないならば、アプリケーションがstreamオブジェクト自体を破壊する前に呼び出されなければなりません。

(現在では、このマクロは何もしません。しかし、ライブラリのバージョンが将来変ると変るかもしれません。)

#define fdev_get_udata ( stream ) ((stream)->udata)

このマクロは、FILEストリームオブジェクトからのユーザ定義データへのポインタを取り出します。

#define fdev_set_udata	(	stream,
		u
	)	do { (stream)->udata = u; } while(0)

このマクロは、FILEストリームオブジェクトにユーザ定義データのポインタへ書き込みます。

ユーザーデータは、fdevopen()関数へ提供されたputやget関数内の状態追跡のために有用です。

#define fdev_setup_stream	(	stream,
		put,
		get,
		rwflag
	)

stdioストリームのようなユーザ提供バッファのセットアップ

このマクロは、ゆーざが提供するバッファストリームを使用し、fdevopen()により動的に取得されたものと同様に標準入出力操作のために有効なストリームをセットアップします。設定されるバッファは、FILEタイプでなければいけません。

putやgetの引数は、fdevopen()に渡す必要があるものと全く同じです。

rwflag引数は、それぞれ_FDEV_SETUP_READ、_FDEV_SETUP_WRITE、または_FDEV_SETUP_RWの読出し、書込み、読み書きを意図する一つの値を取ることができます。

注釈：: 標準ストリームへの割当ては、fdev_setup_stream()によって実行されません。もし標準ストリームを使用する場合は、ユーザによって割り当てる必要があります。malloc()を使わず標準入出力を動かすを参照してください。

#define FDEV_SETUP_STREAM	(	put,
		get,
		rwflag
	)

ユーザ提供の標準入出力ストリームの初期化処理

このマクロは、fdev_setup_stream()と同じ動作をしますが、FILEタイプ変数の初期化処理として使用されます。

残りの引数は、fdev_setup_stream()で説明されたように使用されます。

#define FILE struct __file

FILEは、様々な標準入出力関数で渡される不透明な構造体です。

#define getc ( __stream ) fgetc(__stream)

getcマクロは、fgetc()関数と同一の機能をもつ「高速」マクロとして使われます。スペース抑制のため、avr-libcでは、単にfgetcの別名になっています。

#define getchar ( void ) fgetc(stdin)

getcharマクロは、stdinから文字を読み出します。返値とエラー処理は、fgetc()と同じです。

#define putc	(	__c,
		__stream
	)	fputc(__c, __stream)

putcマクロは、fputc()関数と同一の機能をもつ「高速」マクロとして使われます。スペース抑制のため、avr-libcでは、単にfputcの別名になっています。

#define putchar ( __c ) fputc(__c, stdout)

putcharマクロは、stdoutへ c 文字を送り出します。

#define stderr (__iob[2])

Stream destined for error output. Unless specifically assigned, identical to stdout.

If stderr should point to another stream, the result of another fdevopen() must be explicitly assigned to it without closing the previous stderr (since this would also close stdout).

#define stdin (__iob[0])

Stream that will be used as an input stream by the simplified functions that don't take a stream argument.

The first stream opened with read intent using fdevopen() will be assigned to stdin.

#define stdout (__iob[1])

Stream that will be used as an output stream by the simplified functions that don't take a stream argument.

The first stream opened with write intent using fdevopen() will be assigned to both, stdin, and stderr.

関数ドキュメント

void clearerr ( FILE * __stream )

Clear the error and end-of-file flags of stream.

int fclose ( FILE * __stream )

This function closes stream, and disallows and further IO to and from it.

When using fdevopen() to setup the stream, a call to fclose() is needed in order to free the internal resources allocated.

If the stream has been set up using fdev_setup_stream() or FDEV_SETUP_STREAM(), use fdev_close() instead.

It currently always returns 0 (for success).

FILE* fdevopen	(	int()(char, FILE )	put,
		int()(FILE )	get
	)

This function is a replacement for fopen().

It opens a stream for a device where the actual device implementation needs to be provided by the application. If successful, a pointer to the structure for the opened stream is returned. Reasons for a possible failure currently include that neither the put nor the get argument have been provided, thus attempting to open a stream with no IO intent at all, or that insufficient dynamic memory is available to establish a new stream.

If the put function pointer is provided, the stream is opened with write intent. The function passed as put shall take two arguments, the first a character to write to the device, and the second a pointer to FILE, and shall return 0 if the output was successful, and a nonzero value if the character could not be sent to the device.

If the get function pointer is provided, the stream is opened with read intent. The function passed as get shall take a pointer to FILE as its single argument, and return one character from the device, passed as an int type. If an error occurs when trying to read from the device, it shall return _FDEV_ERR. If an end-of-file condition was reached while reading from the device, _FDEV_EOF shall be returned.

If both functions are provided, the stream is opened with read and write intent.

The first stream opened with read intent is assigned to stdin, and the first one opened with write intent is assigned to both, stdout and stderr.

fdevopen() uses calloc() (und thus malloc()) in order to allocate the storage for the new stream.

注釈：: If the macro __STDIO_FDEVOPEN_COMPAT_12 is declared before including <stdio.h>, a function prototype for fdevopen() will be chosen that is backwards compatible with avr-libc version 1.2 and before. This is solely intented for providing a simple migration path without the need to immediately change all source code. Do not use for new code.

int feof ( FILE * __stream )

Test the end-of-file flag of stream. This flag can only be cleared by a call to clearerr().

int ferror ( FILE * __stream )

Test the error flag of stream. This flag can only be cleared by a call to clearerr().

int fflush ( FILE * stream )

Flush stream.

This is a null operation provided for source-code compatibility only, as the standard IO implementation currently does not perform any buffering.

int fgetc ( FILE * __stream )

The function fgetc reads a character from stream. It returns the character, or EOF in case end-of-file was encountered or an error occurred. The routines feof() or ferror() must be used to distinguish between both situations.

char* fgets	(	char *	__str,
		int	__size,
		FILE *	__stream
	)

Read at most size - 1 bytes from stream, until a newline character was encountered, and store the characters in the buffer pointed to by str. Unless an error was encountered while reading, the string will then be terminated with a NUL character.

If an error was encountered, the function returns NULL and sets the error flag of stream, which can be tested using ferror(). Otherwise, a pointer to the string will be returned.

int fprintf	(	FILE *	__stream,
		const char *	__fmt,
			...
	)

fprintf関数は、streamへフォーマット済み出力を行います。詳細はvfprintf()を参照ください。

int fprintf_P	(	FILE *	__stream,
		const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するfprintf()の別形

int fputc	(	int	__c,
		FILE *	__stream
	)

The function fputc sends the character c (though given as type int) to stream. It returns the character, or EOF in case an error occurred.

int fputs	(	const char *	__str,
		FILE *	__stream
	)

streamへstrのポインタが示す文字列を書き込む

成功時に0を、エラー時にEOFを返す

int fputs_P	(	const char *	__str,
		FILE *	__stream
	)

プログラムメモリにあるstrを使用するfputs()の別形

size_t fread	(	void *	__ptr,
		size_t	__size,
		size_t	__nmemb,
		FILE *	__stream
	)

Read nmemb objects, size bytes each, from stream, to the buffer pointed to by ptr.

Returns the number of objects successfully read, i. e. nmemb unless an input error occured or end-of-file was encountered. feof() and ferror() must be used to distinguish between these two conditions.

int fscanf	(	FILE *	__stream,
		const char *	__fmt,
			...
	)

fscanf関数は、streamから入力データを読み込み、フォーマット済み入力を実行します。

詳細はvfscanf()を参照ください。

int fscanf_P	(	FILE *	__stream,
		const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するfscanf()の別形

size_t fwrite	(	const void *	__ptr,
		size_t	__size,
		size_t	__nmemb,
		FILE *	__stream
	)

Write nmemb objects, size bytes each, to stream. The first byte of the first object is referenced by ptr.

Returns the number of objects successfully written, i. e. nmemb unless an output error occured.

char* gets ( char * __str )

Similar to fgets() except that it will operate on stream stdin, and the trailing newline (if any) will not be stored in the string. It is the caller's responsibility to provide enough storage to hold the characters read.

int printf	(	const char *	__fmt,
			...
	)

printf関数は、stdoutストリームへフォーマット済み出力をする。詳細はvfprintf()を参照ください。

int printf_P	(	const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するprintf()の別形

int puts ( const char * __str )

stdoutへ、strのポインタが指す文字列を書き、改行文字を書き込む

int puts_P ( const char * __str )

プログラムメモリにあるstrを使用するputs()の別形

int scanf	(	const char *	__fmt,
			...
	)

scanf関数は、stdinからのフォーマット済み入力を処理します。

詳細はvfscanf()を参照ください。

int scanf_P	(	const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するscanf()の別形

int snprintf	(	char *	__s,
		size_t	__n,
		const char *	__fmt,
			...
	)

sを無限長と仮定せず、n文字(後置のNUL文字を含む)以下としてsを変換するsprintf()の類形

十分なスペースがあったなら、sに書き込まれた文字数を返します。

int snprintf_P	(	char *	__s,
		size_t	__n,
		const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するsnprintf()の別形

int sprintf	(	char *	__s,
		const char *	__fmt,
			...
	)

s文字列へフォーマット済み文字を書き込むprintf()の別形

int sprintf_P	(	char *	__s,
		const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するsprintf()の別形

int sscanf	(	const char *	__buf,
		const char *	__fmt,
			...
	)

sscanf関数は、bufポインタのバッファから入力データを読み出しフォーマット済み入力を行う。

詳細はvfscanf()を参照ください。

int sscanf_P	(	const char *	__buf,
		const char *	__fmt,
			...
	)

プログラムメモリにあるfmt文字列を使用するsscanf()>の別形

int ungetc	(	int	__c,
		FILE *	__stream
	)

The ungetc() function pushes the character c (converted to an unsigned char) back onto the input stream pointed to by stream. The pushed-back character will be returned by a subsequent read on the stream.

Currently, only a single character can be pushed back onto the stream.

The ungetc() function returns the character pushed back after the conversion, or EOF if the operation fails. If the value of the argument c character equals EOF, the operation will fail and the stream will remain unchanged.

int vfprintf	(	FILE *	__stream,
		const char *	__fmt,
		va_list	__ap
	)

vfprintf is the central facility of the printf family of functions. It outputs values to stream under control of a format string passed in fmt. The actual values to print are passed as a variable argument list ap.

vfprintf returns the number of characters written to stream, or EOF in case of an error. Currently, this will only happen if stream has not been opened with write intent.

The format string is composed of zero or more directives: ordinary characters (not %), which are copied unchanged to the output stream; and conversion specifications, each of which results in fetching zero or more subsequent arguments. Each conversion specification is introduced by the % character. The arguments must properly correspond (after type promotion) with the conversion specifier. After the %, the following appear in sequence:

Zero or more of the following flags:
- # The value should be converted to an "alternate form". For c, d, i, s, and u conversions, this option has no effect. For o conversions, the precision of the number is increased to force the first character of the output string to a zero (except if a zero value is printed with an explicit precision of zero). For x and X conversions, a non-zero result has the string `0x' (or `0X' for X conversions) prepended to it.
- 0 (zero) Zero padding. For all conversions, the converted value is padded on the left with zeros rather than blanks. If a precision is given with a numeric conversion (d, i, o, u, i, x, and X), the 0 flag is ignored.
- - A negative field width flag; the converted value is to be left adjusted on the field boundary. The converted value is padded on the right with blanks, rather than on the left with blanks or zeros. A - overrides a 0 if both are given.
- ' ' (space) A blank should be left before a positive number produced by a signed conversion (d, or i).
- + A sign must always be placed before a number produced by a signed conversion. A + overrides a space if both are used.

An optional decimal digit string specifying a minimum field width. If the converted value has fewer characters than the field width, it will be padded with spaces on the left (or right, if the left-adjustment flag has been given) to fill out the field width.
An optional precision, in the form of a period . followed by an optional digit string. If the digit string is omitted, the precision is taken as zero. This gives the minimum number of digits to appear for d, i, o, u, x, and X conversions, or the maximum number of characters to be printed from a string for s conversions.
An optional l or h length modifier, that specifies that the argument for the d, i, o, u, x, or X conversion is a "long int" rather than int. The h is ignored, as "short int" is equivalent to int.
A character that specifies the type of conversion to be applied.

The conversion specifiers and their meanings are:

diouxX The int (or appropriate variant) argument is converted to signed decimal (d and i), unsigned octal (o), unsigned decimal (u), or unsigned hexadecimal (x and X) notation. The letters "abcdef" are used for x conversions; the letters "ABCDEF" are used for X conversions. The precision, if any, gives the minimum number of digits that must appear; if the converted value requires fewer digits, it is padded on the left with zeros.
p The void * argument is taken as an unsigned integer, and converted similarly as a %#x command would do.
c The int argument is converted to an "unsigned char", and the resulting character is written.
s The "char *" argument is expected to be a pointer to an array of character type (pointer to a string). Characters from the array are written up to (but not including) a terminating NUL character; if a precision is specified, no more than the number specified are written. If a precision is given, no null character need be present; if the precision is not specified, or is greater than the size of the array, the array must contain a terminating NUL character.
% A % is written. No argument is converted. The complete conversion specification is "%%".
eE The double argument is rounded and converted in the format "[-]d.dddeﾂｱdd" where there is one digit before the decimal-point character and the number of digits after it is equal to the precision; if the precision is missing, it is taken as 6; if the precision is zero, no decimal-point character appears. An E conversion uses the letter 'E' (rather than 'e') to introduce the exponent. The exponent always contains two digits; if the value is zero, the exponent is 00.
fF The double argument is rounded and converted to decimal notation in the format "[-]ddd.ddd", where the number of digits after the decimal-point character is equal to the precision specification. If the precision is missing, it is taken as 6; if the precision is explicitly zero, no decimal-point character appears. If a decimal point appears, at least one digit appears before it.
gG The double argument is converted in style f or e (or F or E for G conversions). The precision specifies the number of significant digits. If the precision is missing, 6 digits are given; if the precision is zero, it is treated as 1. Style e is used if the exponent from its conversion is less than -4 or greater than or equal to the precision. Trailing zeros are removed from the fractional part of the result; a decimal point appears only if it is followed by at least one digit.
S Similar to the s format, except the pointer is expected to point to a program-memory (ROM) string instead of a RAM string.

In no case does a non-existent or small field width cause truncation of a numeric field; if the result of a conversion is wider than the field width, the field is expanded to contain the conversion result.

Since the full implementation of all the mentioned features becomes fairly large, three different flavours of vfprintf() can be selected using linker options. The default vfprintf() implements all the mentioned functionality except floating point conversions. A minimized version of vfprintf() is available that only implements the very basic integer and string conversion facilities, but only the # additional option can be specified using conversion flags (these flags are parsed correctly from the format specification, but then simply ignored). This version can be requested using the following compiler options:

   -Wl,-u,vfprintf -lprintf_min

If the full functionality including the floating point conversions is required, the following options should be used:

   -Wl,-u,vfprintf -lprintf_flt -lm

Limitations:

The specified width and precision can be at most 255.

Notes:

For floating-point conversions, if you link default or minimized version of vfprintf(), the symbol ? will be output and double argument will be skiped. So you output below will not be crashed. For default version the width field and the "pad to left" ( symbol minus ) option will work in this case.
The hh length modifier is ignored (char argument is promouted to int). More exactly, this realization does not check the number of h symbols.
But the ll length modifier will to abort the output, as this realization does not operate long long arguments.
The variable width or precision field (an asterisk * symbol) is not realized and will to abort the output.

int vfprintf_P	(	FILE *	__stream,
		const char *	__fmt,
		va_list	__ap
	)

プログラムメモリにあるfmt文字列を使用するvfprintf()の別形

int vfscanf	(	FILE *	stream,
		const char *	fmt,
		va_list	ap
	)

Formatted input. This function is the heart of the scanf family of functions.

Characters are read from stream and processed in a way described by fmt. Conversion results will be assigned to the parameters passed via ap.

The format string fmt is scanned for conversion specifications. Anything that doesn't comprise a conversion specification is taken as text that is matched literally against the input. White space in the format string will match any white space in the data (including none), all other characters match only itself. Processing is aborted as soon as the data and format string no longer match, or there is an error or end-of-file condition on stream.

Most conversions skip leading white space before starting the actual conversion.

Conversions are introduced with the character %. Possible options can follow the %:

a * indicating that the conversion should be performed but the conversion result is to be discarded; no parameters will be processed from ap,
the character h indicating that the argument is a pointer to short int (rather than int),
the 2 characters hh indicating that the argument is a pointer to char (rather than int).
the character l indicating that the argument is a pointer to long int (rather than int, for integer type conversions), or a pointer to double (for floating point conversions),

In addition, a maximal field width may be specified as a nonzero positive decimal integer, which will restrict the conversion to at most this many characters from the input stream. This field width is limited to at most 255 characters which is also the default value (except for the c conversion that defaults to 1).

The following conversion flags are supported:

% Matches a literal % character. This is not a conversion.
d Matches an optionally signed decimal integer; the next pointer must be a pointer to int.
i Matches an optionally signed integer; the next pointer must be a pointer to int. The integer is read in base 16 if it begins with 0x or 0X, in base 8 if it begins with 0, and in base 10 otherwise. Only characters that correspond to the base are used.
o Matches an octal integer; the next pointer must be a pointer to unsigned int.
u Matches an optionally signed decimal integer; the next pointer must be a pointer to unsigned int.
x Matches an optionally signed hexadecimal integer; the next pointer must be a pointer to unsigned int.
f Matches an optionally signed floating-point number; the next pointer must be a pointer to float.
e, g, F, E, G Equivalent to f.
s Matches a sequence of non-white-space characters; the next pointer must be a pointer to char, and the array must be large enough to accept all the sequence and the terminating NUL character. The input string stops at white space or at the maximum field width, whichever occurs first.
c Matches a sequence of width count characters (default 1); the next pointer must be a pointer to char, and there must be enough room for all the characters (no terminating NUL is added). The usual skip of leading white space is suppressed. To skip white space first, use an explicit space in the format.
[ Matches a nonempty sequence of characters from the specified set of accepted characters; the next pointer must be a pointer to char, and there must be enough room for all the characters in the string, plus a terminating NUL character. The usual skip of leading white space is suppressed. The string is to be made up of characters in (or not in) a particular set; the set is defined by the characters between the open bracket [ character and a close bracket ] character. The set excludes those characters if the first character after the open bracket is a circumflex ^. To include a close bracket in the set, make it the first character after the open bracket or the circumflex; any other position will end the set. The hyphen character - is also special; when placed between two other characters, it adds all intervening characters to the set. To include a hyphen, make it the last character before the final close bracket. For instance, [^]0-9-] means the set of everything except close bracket, zero through nine, and hyphen. The string ends with the appearance of a character not in the (or, with a circumflex, in) set or when the field width runs out. Note that usage of this conversion enlarges the stack expense.
p Matches a pointer value (as printed by p in printf()); the next pointer must be a pointer to void.
n Nothing is expected; instead, the number of characters consumed thus far from the input is stored through the next pointer, which must be a pointer to int. This is not a conversion, although it can be suppressed with the * flag.

These functions return the number of input items assigned, which can be fewer than provided for, or even zero, in the event of a matching failure. Zero indicates that, while there was input available, no conversions were assigned; typically this is due to an invalid input character, such as an alphabetic character for a d conversion. The value EOF is returned if an input failure occurs before any conversion such as an end-of-file occurs. If an error or end-of-file occurs after conversion has begun, the number of conversions which were successfully completed is returned.

By default, all the conversions described above are available except the floating-point conversions and the width is limited to 255 characters. The float-point conversion will be available in the extended version provided by the library libscanf_flt.a. Also in this case the width is not limited (exactly, it is limited to 65535 characters). To link a program against the extended version, use the following compiler flags in the link stage:

     -Wl,-u,vfscanf -lscanf_flt -lm

A third version is available for environments that are tight on space. In addition to the restrictions of the standard one, this version implements no %[ specification. This version is provided in the library libscanf_min.a, and can be requested using the following options in the link stage:

     -Wl,-u,vfscanf -lscanf_min -lm

int vfscanf_P	(	FILE *	__stream,
		const char *	__fmt,
		va_list	__ap
	)

プログラムメモリにあるfmt文字列を使用するvfscanf()の別形

int vprintf	(	const char *	__fmt,
		va_list	__ap
	)

vprintf関数は、stdoutストリームにフォーマット済み出力を行い、vfprintf()のように可変引数リストをとります。

詳細はvfprintf()を参照ください。

int vscanf	(	const char *	__fmt,
		va_list	__ap
	)

vscanf関数は、stdinストリームからフォーマット済みの入力を処理し、vfscanf()のように可変引数リストをとります。

詳細はvfscanf()を参照ください。

int vsnprintf	(	char *	__s,
		size_t	__n,
		const char *	__fmt,
		va_list	ap
	)

sを無限長と仮定せず、n文字(後置のNUL文字を含む)以下としてsを変換するvsprintf()の類形

十分なスペースがあったなら、sに書き込まれた文字数を返します。

int vsnprintf_P	(	char *	__s,
		size_t	__n,
		const char *	__fmt,
		va_list	ap
	)

プログラムメモリにあるfmt文字列を使用するvsnprintf()の別形

int vsprintf	(	char *	__s,
		const char *	__fmt,
		va_list	ap
	)

引数に可変引数リストをとるsprintf()の類形

int vsprintf_P	(	char *	__s,
		const char *	__fmt,
		va_list	ap
	)

プログラムメモリにあるfmt文字列を使用するvsprintf()の別形

AVR Libc Home Page					AVR Libc Development Pages
Main Page	User Manual	Library Reference	FAQ	Alphabetical Index	Example Projects

<stdio.h>: 標準入出力

定義

関数

詳しい説明

標準入出力への導入

コードサイズ 対 機能 のための調整できる選択肢

選ばれたAPIの概要

Flahs ROM内でのフォートマット文字列

malloc()を使わず標準入出力を動かす

例

注釈

定義ドキュメント

関数ドキュメント

コードサイズ対機能のための調整できる選択肢