.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Chris Torek and the American National Standards Committee X3,
.\" on Information Processing Systems.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)scanf.3	6.14 (Berkeley) 1/8/93
.\"
.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu
.\" modified to resemble the GNU libio setup used in the Linux libc 
.\" used in versions 4.x (x>4) and 5   Helmut.Geyer@iwr.uni-heidelberg.de
.\" Modified, aeb, 970121
.\"
.\" Japanese Version Copyright (c) 1997 YOSHINO Takashi
.\"       all rights reserved.
.\" Translated Tue Feb 17 10:57:14 JST 1998
.\"       by YOSHINO Takashi <yoshino@civil.jcn.nihon-u.ac.jp>
.\"
.TH SCANF 3  1995-11-01 "LINUX MANPAGE" "Linux Programmer's Manual"
.SH ̾
scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- դѴ
.SH 
.nf
.B #include <stdio.h>
.na
.BI "int scanf(const char *" format ", ..." );
.br
.BI "int fscanf(FILE *" stream ", const char *" format ", ..." );
.br
.BI "int sscanf(const char *" str ", const char *" format ", ..." );
.sp
.B #include <stdarg.h>
.BI "int vscanf(const char *" format ", va_list " ap );
.br
.BI "int vsscanf(const char *" str ", const char *" format ", va_list " ap );
.br
.BI "int vfscanf(FILE *" stream ", const char *" format ", va_list " ap );
.ad
.SH 
.B scanf
ؿ롼פϡʲ˽Ҥ٤褦ˡ
.I format
˽äϤɤ߹ΤǤ롣
ν񼰤
.I "Ѵʸ"
(conversion specifiers)
ޤࡣѴη̤ (⤷)
.I pointer
̤¸롣
.B scanf
ؿɸϥȥ꡼
.I stdin
Ϥɤ߹ࡣ
.B fscanf
ϥȥ꡼ݥ
.I stream
Ϥɤ߹ࡣ
.B sscanf
ʸݥ
.I str
Ǽ줿ʸ󤫤Ϥɤ߹ࡣ
.PP
.B vfscanf
ؿ
.BR vfprintf (3)
Ʊͤˡȥ꡼ݥ
.I stream
Ϥݥ󥿤βĹꥹȤѤɤ߹
.RB ( stdarg (3)
򸫤)
.B vscanf
ؿϡɸϤβĹΥꥹȤɤ߼롣
ơ
.B vsscanf
ؿϤΥꥹȤʸ󤫤ɤ߼롣

.B vprintf

.B vsprintf
ؿƱͤǤ롣
.PP
եޥåʸθ³
.I pointer
ϡҤȤĤҤȤĤ
ѴʸбʤФʤʤ
(㳰ˤĤƤϰʲ `޻' ߤ)
٤ƤѴ
.B %
ʸ (ѡȵ) ˤäƼ롣
.I format
ʸϡ¾ʸޤɤ
.I format
ʸ (򡢥֡ԤȤä) ۥ磻ȥڡϡ
Ϥ (ֲʤפޤ) 0 İʾΥۥ磻ȥڡбƤ롣
¾Τ٤Ƥʸϡ켫ȤΤߤб롣
ɤ߹ߤʸեޥåʸȹʤʤߤ롣
ޤѴʤäȤˤߤ (ʲεҤ򻲾Ȥ뤳)
.SH Ѵ
Ѵ򼨤
.B %
ʸ³ơʲ˼褦ʡ
.I ե饰
ʸ⤢롣
.TP
.B *
ؤ޻ߤ롣
ʸˤĤŤѴ̤˹Ԥ뤬ݥ󥿤ϻѤʤ
ĤޤꡢѴη̤ñ˼ΤƤǤ롣
.TP
.B a 
Ѵ
.B s 
ǤꡢʸΤɬפȤ֤ malloc ؿ
ݤ졢Υ֤ؤΥݥ󥿤
.I char
ݥѿ뤳Ȥ򼨤Ƥ롣
Υݥѿϰ˽ƤɬפϤʤ
Υե饰
.I "ANSI C" 
ˤ¸ߤʤ
.TP
.B h
Ѵ
.B dioux
ޤ
.B n
Τ줫ǤꡢΥݥ󥿤
.RI ( int
ǤϤʤ)
.I short  int
ؤΥݥ󥿤Ǥ뤳Ȥ򼨤Ƥ롣
.TP
.B l
Ѵ
.B dioux
.B n
Τ줫Ǥ꼡Υݥ󥿤
.RI ( int
ǤϤʤ)
.I long  int
ؤΥݥ󥿤Ǥ뤳ȡޤϡѴ
.B efg
ΤΤҤȤĤǤ꼡Υݥ󥿤
.RI ( float 
ǤϤʤ)
.I double
ؤΥݥ󥿤Ǥ뤳ȤΤ줫Ǥ뤳Ȥ򼨤Ƥ롣
դĤ
.B l
ե饰ꤹ뤳Ȥ
.B L
ե饰Ǥ롣
.TP
.B L
.B efg
ѴǤ꼡Υݥ󥿤
.I "long double"
ؤΥݥ󥿤Ǥ뤳ȡޤϡ
.B dioux
ѴǤ꼡Υݥ󥿤
.I "long long"
ؤΥݥ󥿤Ǥ뤳ȤΤ줫Ǥ뤳Ȥ򼨤Ƥ롣
(long long 
.I ANSI C
ηǤϤʤȤդ褦
ѤץƤΥƥФ
ܿǽǤϤʤ)
.TP
.B q
L ƱǤ롣
Υե饰
.I "ANSI C"
ˤ¸ߤʤ
.PP
Υե饰˲äơ
.B %
Ѵʸδ֤˥ץǤĤ뤳ȤǤ롢
10 ʤɽ蘆줿ե򤪤ȤǤ롣
⤷ͿʤΤʤ顢(ʲǽҤ٤㳰)
ǥեͤǤ̵פѤ롣
ʳξ硢ο¤Ȥơ¿ʸ
Ѵβɤ߹ޤ롣
ѴϤޤˡۤȤɤѴڡ䥿֤ɤߤȤФ
ΤȤΥۥ磻ȥڡϥեĹ˿ʤ
.PP
ʲѴǽǤ롣
.TP
.B %
ʸ `%' б롣
ʸ `%\&%' ñʸ `%' б롣
ѴϹԤ줺ѿؤʤ
.TP
.B d
Ĥ 10 ʤб롣
Υݥ󥿤
.I int 
ؤΥݥ󥿤ǤʤФʤʤ
.TP
.B D
.B ld 
ƱǤ롣ϰλͤȤθߴΤˤ롣
(:  libc4 ξǤ롣 libc5  glibc Ǥ %D 
ۤΤ̵뤵졢ŤץˤԤθȤʤ롣)
.TP
.B i
Ĥб롣
Υݥ󥿤
.I int 
ؤΥݥ󥿤ǤʤФʤʤ
 `0x' ޤ `0X' dzϤˤ 16 ʿ`0' dzϤ
ˤ 8 ʿ¾ξˤ 10 ʿȤɤ߹ޤ롣
ѴǻѤʸϡδбƤΤǤ롣
.TP
.B o
ʤ 8 ʤб롣
Υݥ󥿤
.I "unsigned int" 
ǤʤƤϤʤʤ
.TP
.B u
ʤ 10 ʤб롣
Υݥ󥿤
.I "unsigned int" 
ؤΥݥ󥿤ǤʤФʤʤ
.TP
.B x
ʤ 16 ʤб롣
Υݥ󥿤
.I "unsigned int" 
ؤΥݥ󥿤ǤʤФʤʤ
.TP
.B X
.B x 
ƱǤ롣
.TP
.B f
Ĥư¿б롣
Υݥ󥿤
.I float 
ؤΥݥ󥿤ǤʤФʤʤ
.TP
.B e
.BR f 
ƱǤ롣
.TP
.B g
.BR f 
ƱǤ롣
.TP
.B E
.BR f 
ƱǤ롣
.TP
.B s
ۥ磻ȥڡǤϤʤʸǹ줿ʸб롣
Υݥ󥿤
.I char 
ؤΥݥ󥿤ǤʤФʤ餺
٤Ƥʸʸν򤷤᤹
.B NUL
ʸǼ뤿ˡϽʬ礭ʤФʤʤ
ʸϤϡ
ۥ磻ȥڡޤϺե (դĤΤǽ
) ˤäߤ롣
.TP
.B c
.I width
Ĥʸνޤ (ǥեȤ 1) б롣
Υݥ󥿤
.I char 
ؤΥݥ󥿤ǤʤФʤ餺٤ƤʸǼ뤿
ʬΰ褬ʤФʤʤ
(üʸ
.B NUL
źդʤ)
̾Υۥ磻ȥڡɤФ롣
Ϥ˥ۥ磻ȥڡɤФˤϡ
եޥåʸŪ˥ڡѤɤ
.TP
.B \&[
Ǽ줿ʸΤФ줿
ꤵ줿ʸνǹǤϤʤʸб롣
Υݥ󥿤
.I char 
ؤΥݥ󥿤ǤʤФʤ餺
ˤʸΤ٤ƤʸȽüʸ
.B NUL
Ǽ뤿νʬΰ褬ʤФʤʤ
̾Υۥ磻ȥڡɤФ롣
ʸ̤ʽʸǹƤ롣
ν

.B [
Ĥ
.B ]
δ֤ʸ롣
̤ΤȤκǽʸʥȵ
.BR ^ 
ξ硢ϤʸޤޤʤΤȤʤ롣
Ĥ̤򽸹˴ޤޤ뤿ˤϡʸ򳫤̤ޤ
ʥȵΤȤκǽʸˤФ褤
Ĥޤꡢ¾ΰ֤Ĥ̤֤ʸν礬롣
ϥե
.B -
ޤüʸǤ롣
Ĥΰۤʤʸδ֤֤줿ʸϡ
δ֤ˤƤʸ򽸹˲ä롣
ϥեΤޤޤ뤿ˤϡ
̤ĤκǸΰʸϥեˤФ褤
㤨 `[^]0-9-]' 
Ĥ̡0  9 ƥϥե 3 Ƥʸ
Ȥȹ礻̣롣
ʸ
˴ޤޤƤʤ (ʥȤξˤϴޤޤ) ʸ
иޤϳݤ줿ΰ褬ȤԤ줿˽λ롣
.TP
.B p
.RB ( printf (3)
 `%p' ǵ褦) ݥͤб롣
Υݥ󥿤
.I void 
ؤΥݥ󥿤ǤʤФʤʤ
.TP
.B n
ɬפȤʤ
Τˡ
Ϥ餳ޤǾ񤵤줿ʸΥݥ󥿤̤
Ǽ롣
Υݥ󥿤
.I int 
ؤΥݥ󥿤ǤʤФʤʤ
.B *
ե饰뤳ȤǤˤ⤫餺ѴǤ
.I ʤ
C ɸ൬ʤϡּ¹Ԥδλ֤β
%n ̿μ¹Ԥäʤפ
äƤ뤬ɽǤϤꤹ褦Ǥ롣
餯֤ͤ %n Ѵθ̤ˤĤƤϤɤΤ褦ʲ⤷ʤ
ȤǤ

.PP
.SH ֤
δؿ줿ǤθĿ֤
Ԥ硢θĿѰդ줿⾯ʤ
0 ˤʤ롣
0 ϤǽǤ֤ˡɤѴͤʤäȤ򼨤Ƥ롣
ŵŪȤƤϡ `%d' Ѵ˥ե٥åʸϤ줿Ȥ褦
ʸŬڤǤäȤ󤲤롣
ǽѴ˥եνüʸ (end-of-file) äơ
ϤμԤˤ
.B EOF
֤롣
顼եνüʸνиѴϤޤäˤϡ
ѴθĿ֤롣
.SH Ϣ
.BR strtol (3),
.BR strtoul (3),
.BR strtod (3),
.BR getc (3),
.BR printf (3)
.SH 
.BR fscanf ,
.BR scanf ,
.B sscanf
ؿ ANSI X3.159-1989 (``ANSI C'') ˽򤷤Ƥ롣
.PP
.B q

.I "long long" 

.I BSD 4.4
ǤεˡǤ롣
ѴǤ
.B ll
ޤ
.B L
λѤ GNU ǤγĥǤ롣
.PP
δؿ Linux Ǥ
.I GNU 
.I libio
饤֥꡼򸵤ˤƤ롣
ʷˤ
.I GNU
.I libc (glibc-1.08)

.I info
ʸܤ̤ȡ
.SH Х
Ƥδؿϡ ANSI X3.159-1989 ˽򤷤Ƥ롣
ɲä
.B q

.B a
ե饰󶡤ƤꡢƱͤ
.B L

.B l
ե饰ղŪʿ񤤤⤢롣Ԥϡ
ANSI X3.159-1989 줿ե饰ο񤤤ѹΤʤΤǡ
ХȤߤʤ뤫⤷ʤ
.PP
.I ANSI C
줿ե饰δĤΥե饰ȹ礻ϡ
.I "ANSI C"
Ǥϰ̣ʤʤΤ
(㤨С
.BR "%Ld" )
Linux Ǥ줿񤤤ĤǤ
ο񤤤¾Υƥ㡼ƱͤˤʤäƤɬפϤʤ
椨ˡۤȤɤξ硢
.I ANSI C
Ƥʤե饰Ѥɤ
ʤ
.B diouxX
Ѵ
.B ll
Ǥϡ
.B L

.B q
Ѥɤ
.PP
.B q
λˡ
.B L 
ƱǤ¿Ѵ˻Ѥ
.IR "BSD 4.4" 
ξƱǤϤʤ