2004-11-03 13:51:07 +00:00
|
|
|
.\" 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.
|
|
|
|
.\"
|
accept.2, bind.2, connect.2, getpeername.2, getpriority.2, getsockname.2, getsockopt.2, ioctl.2, killpg.2, listen.2, lseek.2, readlink.2, recv.2, send.2, setpgid.2, setreuid.2, shutdown.2, socket.2, socketpair.2, syscall.2, truncate.2, alloca.3, btree.3, daemon.3, dbopen.3, err.3, exec.3, fclose.3, ferror.3, fflush.3, fopen.3, fread.3, fseek.3, fts.3, hash.3, mpool.3, popen.3, queue.3, rcmd.3, recno.3, rexec.3, scanf.3, setbuf.3, stdarg.3, stdio.3, strtod.3, hostname.7, mdoc.7, mdoc.samples.7: srcfix: LICENSE: s/BSD_4_CLAUSE_FULL/BSD_4_CLAUSE_UCB/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 16:41:19 +00:00
|
|
|
.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" 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.
|
accept.2, bind.2, connect.2, getpeername.2, getpriority.2, getsockname.2, getsockopt.2, ioctl.2, killpg.2, listen.2, lseek.2, readlink.2, recv.2, send.2, setpgid.2, setreuid.2, shutdown.2, socket.2, socketpair.2, syscall.2, truncate.2, alloca.3, btree.3, daemon.3, dbopen.3, err.3, exec.3, fclose.3, ferror.3, fflush.3, fopen.3, fread.3, fseek.3, fts.3, getloadavg.3, hash.3, mpool.3, openpty.3, popen.3, queue.3, rcmd.3, recno.3, rexec.3, scanf.3, setbuf.3, stdarg.3, stdio.3, strtod.3, hostname.7, mdoc.7, mdoc.samples.7, operator.7, symlink.7: Add LICENSE_START(BSD_[34]_CLAUSE_FULL)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 09:28:48 +00:00
|
|
|
.\" %%%LICENSE_END
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
|
|
|
.\" @(#)scanf.3 6.14 (Berkeley) 1/8/93
|
|
|
|
.\"
|
|
|
|
.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu
|
2007-04-12 22:42:49 +00:00
|
|
|
.\" modified to resemble the GNU libio setup used in the Linux libc
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" used in versions 4.x (x>4) and 5 Helmut.Geyer@iwr.uni-heidelberg.de
|
|
|
|
.\" Modified, aeb, 970121
|
2007-04-12 22:42:49 +00:00
|
|
|
.\" 2005-07-14, mtk, added description of %n$ form; various text
|
|
|
|
.\" incorporated from the GNU C library documentation ((C) The
|
2005-07-14 13:48:54 +00:00
|
|
|
.\" Free Software Foundation); other parts substantially rewritten.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
2008-06-22 13:15:34 +00:00
|
|
|
.\" 2008-06-23, mtk
|
2008-06-22 10:35:40 +00:00
|
|
|
.\" Add ERRORS section.
|
|
|
|
.\" Document the 'a' and 'm' modifiers for dynamic string allocation.
|
2008-03-14 13:24:35 +00:00
|
|
|
.\"
|
getent.1, fallocate.2, getrlimit.2, llseek.2, madvise.2, mount.2, poll.2, posix_fadvise.2, pread.2, stat.2, symlink.2, timer_create.2, timerfd_create.2, unshare.2, acos.3, acosh.3, asin.3, asinh.3, asprintf.3, atan.3, atan2.3, atanh.3, cabs.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cimag.3, clog.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, erf.3, erfc.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, frexp.3, ftw.3, get_nprocs_conf.3, getcwd.3, gethostbyname.3, getnetent.3, getutent.3, glob.3, ilogb.3, insque.3, j0.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lseek64.3, malloc.3, mbsnrtowcs.3, mbsrtowcs.3, modf.3, mq_notify.3, mq_open.3, nan.3, nextafter.3, openpty.3, perror.3, posix_memalign.3, pow.3, printf.3, qsort.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scandir.3, scanf.3, setnetgrent.3, significand.3, sin.3, sinh.3, sqrt.3, strcasecmp.3, tan.3, tanh.3, tgamma.3, trunc.3, unlocked_stdio.3, updwtmp.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wordexp.3, wprintf.3, y0.3, epoll.7, icmp.7, nptl.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:20:58 +00:00
|
|
|
.TH SCANF 3 2015-04-19 "GNU" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
|
|
|
scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.nf
|
|
|
|
.B #include <stdio.h>
|
2008-01-11 13:59:47 +00:00
|
|
|
|
|
|
|
.BI "int scanf(const char *" format ", ...);"
|
|
|
|
.BI "int fscanf(FILE *" stream ", const char *" format ", ...);"
|
|
|
|
.BI "int sscanf(const char *" str ", const char *" format ", ...);"
|
2004-11-03 13:51:07 +00:00
|
|
|
.sp
|
|
|
|
.B #include <stdarg.h>
|
2008-01-11 13:59:47 +00:00
|
|
|
|
2004-11-03 13:51:07 +00:00
|
|
|
.BI "int vscanf(const char *" format ", va_list " ap );
|
|
|
|
.BI "int vsscanf(const char *" str ", const char *" format ", va_list " ap );
|
|
|
|
.BI "int vfscanf(FILE *" stream ", const char *" format ", va_list " ap );
|
2007-07-08 12:11:40 +00:00
|
|
|
.fi
|
|
|
|
.sp
|
|
|
|
.in -4n
|
|
|
|
Feature Test Macro Requirements for glibc (see
|
|
|
|
.BR feature_test_macros (7)):
|
|
|
|
.in
|
2010-09-18 16:16:36 +00:00
|
|
|
.ad l
|
2007-07-08 12:11:40 +00:00
|
|
|
.sp
|
|
|
|
.BR vscanf (),
|
|
|
|
.BR vsscanf (),
|
|
|
|
.BR vfscanf ():
|
2010-09-18 16:16:36 +00:00
|
|
|
.RS 4
|
_exit.2, brk.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, posix_memalign.3, pow.3, remainder.3, remquo.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3: Simplify FTM requirements
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
can be simplified to:
_POSIX_C_SOURCE\ >=\ 200112L
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>`
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-08 11:06:15 +00:00
|
|
|
_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
|
2010-09-18 16:16:36 +00:00
|
|
|
.ad
|
|
|
|
.RE
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR scanf ()
|
2005-07-14 13:48:54 +00:00
|
|
|
family of functions scans input according to
|
2004-11-03 13:51:07 +00:00
|
|
|
.I format
|
2007-04-12 22:42:49 +00:00
|
|
|
as described below.
|
|
|
|
This format may contain
|
2005-07-14 13:48:54 +00:00
|
|
|
.IR "conversion specifications" ;
|
|
|
|
the results from such conversions, if any,
|
|
|
|
are stored in the locations pointed to by the
|
2007-04-12 22:42:49 +00:00
|
|
|
.I pointer
|
2005-07-14 13:48:54 +00:00
|
|
|
arguments that follow
|
|
|
|
.IR format .
|
2007-04-12 22:42:49 +00:00
|
|
|
Each
|
2004-11-03 13:51:07 +00:00
|
|
|
.I pointer
|
2007-04-12 22:42:49 +00:00
|
|
|
argument must be of a type that is appropriate for the value returned
|
2005-07-14 13:48:54 +00:00
|
|
|
by the corresponding conversion specification.
|
|
|
|
|
|
|
|
If the number of conversion specifications in
|
|
|
|
.I format
|
|
|
|
exceeds the number of
|
|
|
|
.I pointer
|
|
|
|
arguments, the results are undefined.
|
|
|
|
If the number of
|
|
|
|
.I pointer
|
|
|
|
arguments exceeds the number of conversion specifications, then the excess
|
|
|
|
.I pointer
|
|
|
|
arguments are evaluated, but are otherwise ignored.
|
|
|
|
|
|
|
|
The
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR scanf ()
|
2004-11-03 13:51:07 +00:00
|
|
|
function reads input from the standard input stream
|
|
|
|
.IR stdin ,
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR fscanf ()
|
2004-11-03 13:51:07 +00:00
|
|
|
reads input from the stream pointer
|
|
|
|
.IR stream ,
|
|
|
|
and
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR sscanf ()
|
2004-11-03 13:51:07 +00:00
|
|
|
reads its input from the character string pointed to by
|
|
|
|
.IR str .
|
|
|
|
.PP
|
|
|
|
The
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR vfscanf ()
|
2004-11-03 13:51:07 +00:00
|
|
|
function is analogous to
|
|
|
|
.BR vfprintf (3)
|
|
|
|
and reads input from the stream pointer
|
|
|
|
.I stream
|
|
|
|
using a variable argument list of pointers (see
|
|
|
|
.BR stdarg (3).
|
|
|
|
The
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR vscanf ()
|
2004-11-03 13:51:07 +00:00
|
|
|
function scans a variable argument list from the standard input and the
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR vsscanf ()
|
2004-11-03 13:51:07 +00:00
|
|
|
function scans it from a string; these are analogous to the
|
2007-05-12 00:30:29 +00:00
|
|
|
.BR vprintf (3)
|
2004-11-03 13:51:07 +00:00
|
|
|
and
|
2007-05-12 00:30:29 +00:00
|
|
|
.BR vsprintf (3)
|
2004-11-03 13:51:07 +00:00
|
|
|
functions respectively.
|
|
|
|
.PP
|
2005-07-14 13:48:54 +00:00
|
|
|
The
|
|
|
|
.I format
|
2007-04-12 22:42:49 +00:00
|
|
|
string consists of a sequence of
|
2007-09-20 16:26:31 +00:00
|
|
|
.I directives
|
2005-07-14 13:48:54 +00:00
|
|
|
which describe how to process the sequence of input characters.
|
|
|
|
If processing of a directive fails, no further input is read, and
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR scanf ()
|
2005-07-14 13:48:54 +00:00
|
|
|
returns.
|
|
|
|
A "failure" can be either of the following:
|
|
|
|
.IR "input failure" ,
|
|
|
|
meaning that input characters were unavailable, or
|
|
|
|
.IR "matching failure" ,
|
|
|
|
meaning that the input was inappropriate (see below).
|
|
|
|
|
|
|
|
A directive is one of the following:
|
|
|
|
.TP
|
|
|
|
\(bu
|
2007-12-22 22:43:42 +00:00
|
|
|
A sequence of white-space characters (space, tab, newline, etc.; see
|
2005-07-14 13:48:54 +00:00
|
|
|
.BR isspace (3)).
|
|
|
|
This directive matches any amount of white space,
|
|
|
|
including none, in the input.
|
|
|
|
.TP
|
|
|
|
\(bu
|
2008-06-09 21:03:52 +00:00
|
|
|
An ordinary character (i.e., one other than white space or \(aq%\(aq).
|
2005-07-14 13:48:54 +00:00
|
|
|
This character must exactly match the next character of input.
|
|
|
|
.TP
|
|
|
|
\(bu
|
2008-06-09 21:03:52 +00:00
|
|
|
A conversion specification,
|
|
|
|
which commences with a \(aq%\(aq (percent) character.
|
2007-04-12 22:42:49 +00:00
|
|
|
A sequence of characters from the input is converted according to
|
2005-07-14 13:48:54 +00:00
|
|
|
this specification, and the result is placed in the corresponding
|
2004-11-03 13:51:07 +00:00
|
|
|
.I pointer
|
2005-07-14 13:48:54 +00:00
|
|
|
argument.
|
2007-06-14 20:04:32 +00:00
|
|
|
If the next item of input does not match the conversion specification,
|
intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash
Normal English typographical convention is not to have
spaces around em dashes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 06:47:35 +00:00
|
|
|
the conversion fails\(emthis is a
|
2005-07-14 13:48:54 +00:00
|
|
|
.IR "matching failure" .
|
|
|
|
.PP
|
|
|
|
Each
|
2007-04-12 22:42:49 +00:00
|
|
|
.I conversion specification
|
2005-07-14 13:48:54 +00:00
|
|
|
in
|
2007-04-12 22:42:49 +00:00
|
|
|
.I format
|
2008-06-09 21:03:52 +00:00
|
|
|
begins with either the character \(aq%\(aq or the character sequence
|
2005-07-14 13:48:54 +00:00
|
|
|
"\fB%\fP\fIn\fP\fB$\fP"
|
2006-07-05 09:01:30 +00:00
|
|
|
(see below for the distinction) followed by:
|
2005-07-14 13:48:54 +00:00
|
|
|
.TP
|
|
|
|
\(bu
|
2008-06-09 21:03:52 +00:00
|
|
|
An optional \(aq*\(aq assignment-suppression character:
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR scanf ()
|
2005-07-14 13:48:54 +00:00
|
|
|
reads input as directed by the conversion specification,
|
|
|
|
but discards the input.
|
|
|
|
No corresponding
|
|
|
|
.I pointer
|
|
|
|
argument is required, and this specification is not
|
|
|
|
included in the count of successful assignments returned by
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR scanf ().
|
2005-07-14 13:48:54 +00:00
|
|
|
.TP
|
|
|
|
\(bu
|
2013-02-02 01:17:46 +00:00
|
|
|
An optional \(aqm\(aq character.
|
2013-02-02 08:14:35 +00:00
|
|
|
This is used with string conversions
|
|
|
|
.RI ( %s ,
|
|
|
|
.IR %c ,
|
|
|
|
.IR %[ ),
|
|
|
|
and relieves the caller of the
|
2005-07-14 13:48:54 +00:00
|
|
|
need to allocate a corresponding buffer to hold the input: instead,
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR scanf ()
|
2007-04-12 22:42:49 +00:00
|
|
|
allocates a buffer of sufficient size,
|
2005-07-14 13:48:54 +00:00
|
|
|
and assigns the address of this buffer to the corresponding
|
|
|
|
.I pointer
|
|
|
|
argument, which should be a pointer to a
|
arch_prctl.2, getpeername.2, getrlimit.2, ioctl_list.2, mmap2.2, mremap.2, sched_setaffinity.2, setup.2, shmop.2, argz_add.3, exec.3, fenv.3, fmtmsg.3, gethostbyname.3, posix_memalign.3, printf.3, scanf.3, sigpause.3, wordexp.3, xdr.3, st.4, tty_ioctl.4: Formatting fix: prevent '*' in declaration or cast wrapping to next line
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-06-07 17:12:39 +00:00
|
|
|
.I "char\ *"
|
2007-06-08 09:56:56 +00:00
|
|
|
variable (this variable does not need to be initialized before the call).
|
2005-07-14 13:48:54 +00:00
|
|
|
The caller should subsequently
|
|
|
|
.BR free (3)
|
|
|
|
this buffer when it is no longer required.
|
|
|
|
.TP
|
|
|
|
\(bu
|
|
|
|
An optional decimal integer which specifies the
|
|
|
|
.IR "maximum field width" .
|
2007-04-12 22:42:49 +00:00
|
|
|
Reading of characters stops either when this maximum is reached or
|
accept.2, access.2, acct.2, clock_nanosleep.2, mbind.2, mincore.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, splice.2, stat.2, syslog.2, timer_create.2, timerfd_create.2, truncate.2, fenv.3, ferror.3, fflush.3, fgetwc.3, fgetws.3, flockfile.3, fputwc.3, fputws.3, fread.3, getopt.3, gets.3, getwchar.3, glob.3, iconv.3, longjmp.3, pow.3, printf.3, puts.3, putwchar.3, regex.3, rpc.3, scanf.3, setjmp.3, termios.3, unlocked_stdio.3, wcswidth.3, hd.4, rtc.4, st.4, core.5, dir_colors.5, elf.5, proc.5, arp.7, ascii.7, boot.7, bootparam.7, charsets.7, futex.7, ip.7, iso_8859-11.7, man-pages.7, man.7, mdoc.samples.7, path_resolution.7, pipe.7, posixoptions.7, unicode.7, unix.7, uri.7, utf-8.7, ld.so.8: s/non-/non/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:20:12 +00:00
|
|
|
when a nonmatching character is found, whichever happens first.
|
2008-07-07 14:37:42 +00:00
|
|
|
Most conversions discard initial white space characters (the exceptions
|
2007-04-12 22:42:49 +00:00
|
|
|
are noted below),
|
Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 05:34:47 +00:00
|
|
|
and these discarded characters don't count toward the maximum field width.
|
gets.3, mbtowc.3, printf.3, puts.3, scanf.3, stpcpy.3, stpncpy.3, strcat.3, strlen.3, strnlen.3, strsep.3, strstr.3, strxfrm.3, utmp.5: Global fix: consistent use of "null byte"
Bring more consistency to the discussion of
"[terminating] null byte"
by writing (at least in the initial use in a page)
"[terminating] null byte ('\0')".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 04:16:17 +00:00
|
|
|
String input conversions store a terminating null byte (\(aq\\0\(aq)
|
2007-04-12 22:42:49 +00:00
|
|
|
to mark the end of the input;
|
2005-07-14 13:48:54 +00:00
|
|
|
the maximum field width does not include this terminator.
|
|
|
|
.TP
|
|
|
|
\(bu
|
2007-04-12 22:42:49 +00:00
|
|
|
An optional
|
|
|
|
.IR "type modifier character" .
|
2005-07-14 13:48:54 +00:00
|
|
|
For example, the
|
|
|
|
.B l
|
2007-04-12 22:42:49 +00:00
|
|
|
type modifier is used with integer conversions such as
|
2007-07-09 21:02:59 +00:00
|
|
|
.B %d
|
2005-07-14 13:48:54 +00:00
|
|
|
to specify that the corresponding
|
|
|
|
.I pointer
|
2007-04-12 22:42:49 +00:00
|
|
|
argument refers to a
|
2005-07-14 13:48:54 +00:00
|
|
|
.I "long int"
|
2007-04-12 22:42:49 +00:00
|
|
|
rather than a pointer to an
|
2005-07-14 13:48:54 +00:00
|
|
|
.IR int .
|
|
|
|
.TP
|
|
|
|
\(bu
|
2007-04-12 22:42:49 +00:00
|
|
|
A
|
2005-07-14 13:48:54 +00:00
|
|
|
.I "conversion specifier"
|
|
|
|
that specifies the type of input conversion to be performed.
|
2007-04-12 22:42:49 +00:00
|
|
|
.PP
|
2005-07-14 13:48:54 +00:00
|
|
|
The conversion specifications in
|
2004-11-03 13:51:07 +00:00
|
|
|
.I format
|
2008-06-09 21:03:52 +00:00
|
|
|
are of two forms, either beginning with \(aq%\(aq or beginning with
|
2005-07-14 13:48:54 +00:00
|
|
|
"\fB%\fP\fIn\fP\fB$\fP".
|
2007-04-12 22:42:49 +00:00
|
|
|
The two forms should not be mixed in the same
|
2004-11-03 13:51:07 +00:00
|
|
|
.I format
|
2007-04-12 22:42:49 +00:00
|
|
|
string, except that a string containing
|
2005-07-14 13:48:54 +00:00
|
|
|
"\fB%\fP\fIn\fP\fB$\fP"
|
|
|
|
specifications can include
|
2007-07-09 21:02:59 +00:00
|
|
|
.B %%
|
2007-04-12 22:42:49 +00:00
|
|
|
and
|
2007-07-09 21:02:59 +00:00
|
|
|
.BR %* .
|
2005-07-14 13:48:54 +00:00
|
|
|
If
|
|
|
|
.I format
|
2008-06-09 21:03:52 +00:00
|
|
|
contains \(aq%\(aq
|
2014-03-26 05:06:06 +00:00
|
|
|
specifications, then these correspond in order with successive
|
2005-07-14 13:48:54 +00:00
|
|
|
.I pointer
|
|
|
|
arguments.
|
|
|
|
In the
|
|
|
|
"\fB%\fP\fIn\fP\fB$\fP"
|
2006-08-03 13:57:30 +00:00
|
|
|
form (which is specified in POSIX.1-2001, but not C99),
|
2005-07-14 13:48:54 +00:00
|
|
|
.I n
|
2007-04-12 22:42:49 +00:00
|
|
|
is a decimal integer that specifies that the converted input should
|
2005-07-14 13:48:54 +00:00
|
|
|
be placed in the location referred to by the
|
|
|
|
.IR n -th
|
|
|
|
.I pointer
|
|
|
|
argument following
|
|
|
|
.IR format .
|
2007-05-16 17:35:34 +00:00
|
|
|
.SS Conversions
|
2005-07-14 13:48:54 +00:00
|
|
|
The following
|
2007-09-20 16:26:31 +00:00
|
|
|
.I "type modifier characters"
|
2005-07-14 13:48:54 +00:00
|
|
|
can appear in a conversion specification:
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B h
|
|
|
|
Indicates that the conversion will be one of
|
2008-07-12 20:57:29 +00:00
|
|
|
\fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP, or \fBn\fP
|
2004-11-03 13:51:07 +00:00
|
|
|
and the next pointer is a pointer to a
|
2005-07-14 13:48:54 +00:00
|
|
|
.I short int
|
|
|
|
or
|
|
|
|
.I unsigned short int
|
2004-11-03 13:51:07 +00:00
|
|
|
(rather than
|
|
|
|
.IR int ).
|
|
|
|
.TP
|
2005-07-14 13:48:54 +00:00
|
|
|
.B hh
|
|
|
|
As for
|
|
|
|
.BR h ,
|
|
|
|
but the next pointer is a pointer to a
|
|
|
|
.I signed char
|
|
|
|
or
|
|
|
|
.IR "unsigned char" .
|
|
|
|
.TP
|
|
|
|
.B j
|
|
|
|
As for
|
|
|
|
.BR h ,
|
2007-12-29 18:01:05 +00:00
|
|
|
but the next pointer is a pointer to an
|
2005-07-14 13:48:54 +00:00
|
|
|
.I intmax_t
|
2007-12-29 18:01:05 +00:00
|
|
|
or a
|
2005-07-14 13:48:54 +00:00
|
|
|
.IR uintmax_t .
|
|
|
|
This modifier was introduced in C99.
|
|
|
|
.TP
|
2004-11-03 13:51:07 +00:00
|
|
|
.B l
|
|
|
|
Indicates either that the conversion will be one of
|
2008-07-12 20:57:29 +00:00
|
|
|
\fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, \fBX\fP, or \fBn\fP
|
2004-11-03 13:51:07 +00:00
|
|
|
and the next pointer is a pointer to a
|
2005-07-14 13:48:54 +00:00
|
|
|
.I long int
|
|
|
|
or
|
|
|
|
.I unsigned long int
|
2004-11-03 13:51:07 +00:00
|
|
|
(rather than
|
|
|
|
.IR int ),
|
|
|
|
or that the conversion will be one of
|
2008-07-12 20:57:29 +00:00
|
|
|
\fBe\fP, \fBf\fP, or \fBg\fP
|
2004-11-03 13:51:07 +00:00
|
|
|
and the next pointer is a pointer to
|
|
|
|
.I double
|
|
|
|
(rather than
|
|
|
|
.IR float ).
|
2007-04-12 22:42:49 +00:00
|
|
|
Specifying two
|
2004-11-03 13:51:07 +00:00
|
|
|
.B l
|
2005-07-14 13:48:54 +00:00
|
|
|
characters is equivalent to
|
|
|
|
.BR L .
|
|
|
|
If used with
|
2007-07-09 21:02:59 +00:00
|
|
|
.B %c
|
2007-04-12 22:42:49 +00:00
|
|
|
or
|
2014-03-26 04:51:20 +00:00
|
|
|
.BR %s ,
|
2007-04-12 22:42:49 +00:00
|
|
|
the corresponding parameter is considered
|
2007-04-24 19:40:35 +00:00
|
|
|
as a pointer to a wide character or wide-character string respectively.
|
2005-07-14 13:48:54 +00:00
|
|
|
.\" This use of l was introduced in Amendment 1 to ISO C90.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B L
|
|
|
|
Indicates that the conversion will be either
|
2008-07-12 20:57:29 +00:00
|
|
|
\fBe\fP, \fBf\fP, or \fBg\fP
|
2004-11-03 13:51:07 +00:00
|
|
|
and the next pointer is a pointer to
|
2007-09-20 16:26:31 +00:00
|
|
|
.I "long double"
|
2007-04-12 22:42:49 +00:00
|
|
|
or the conversion will be
|
2008-07-12 20:57:29 +00:00
|
|
|
\fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, or \fBx\fP
|
2004-11-03 13:51:07 +00:00
|
|
|
and the next pointer is a pointer to
|
|
|
|
.IR "long long" .
|
2007-04-12 22:42:49 +00:00
|
|
|
.\" MTK, Jul 05: The following is no longer true for modern
|
2005-07-14 13:48:54 +00:00
|
|
|
.\" ANSI C (i.e., C99):
|
2007-04-12 22:42:49 +00:00
|
|
|
.\" (Note that long long is not an
|
|
|
|
.\" ANSI C
|
2005-07-14 13:48:54 +00:00
|
|
|
.\" type. Any program using this will not be portable to all
|
|
|
|
.\" architectures).
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B q
|
2007-04-12 22:42:49 +00:00
|
|
|
equivalent to
|
|
|
|
.BR L .
|
2005-07-14 13:48:54 +00:00
|
|
|
This specifier does not exist in ANSI C.
|
|
|
|
.TP
|
|
|
|
.B t
|
|
|
|
As for
|
|
|
|
.BR h ,
|
|
|
|
but the next pointer is a pointer to a
|
|
|
|
.IR ptrdiff_t .
|
|
|
|
This modifier was introduced in C99.
|
|
|
|
.TP
|
|
|
|
.B z
|
|
|
|
As for
|
|
|
|
.BR h ,
|
|
|
|
but the next pointer is a pointer to a
|
|
|
|
.IR size_t .
|
|
|
|
This modifier was introduced in C99.
|
2004-11-03 13:51:07 +00:00
|
|
|
.PP
|
2007-04-12 22:42:49 +00:00
|
|
|
The following
|
2005-07-14 13:48:54 +00:00
|
|
|
.I "conversion specifiers"
|
|
|
|
are available:
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B %
|
2008-06-09 21:03:52 +00:00
|
|
|
Matches a literal \(aq%\(aq.
|
2007-04-12 22:42:49 +00:00
|
|
|
That is,
|
2007-07-09 21:02:59 +00:00
|
|
|
.B %\&%
|
2005-07-14 13:48:54 +00:00
|
|
|
in the format string matches a
|
2008-06-09 21:03:52 +00:00
|
|
|
single input \(aq%\(aq character.
|
2008-07-07 14:37:42 +00:00
|
|
|
No conversion is done (but initial white space characters are discarded),
|
|
|
|
and assignment does not occur.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B d
|
|
|
|
Matches an optionally signed decimal integer;
|
|
|
|
the next pointer must be a pointer to
|
|
|
|
.IR int .
|
|
|
|
.TP
|
|
|
|
.B D
|
|
|
|
Equivalent to
|
2005-07-14 13:48:54 +00:00
|
|
|
.IR ld ;
|
Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 05:34:47 +00:00
|
|
|
this exists only for backward compatibility.
|
2007-04-12 22:42:49 +00:00
|
|
|
(Note: thus only in libc4.
|
|
|
|
In libc5 and glibc the
|
2007-07-09 21:02:59 +00:00
|
|
|
.B %D
|
2005-07-14 13:48:54 +00:00
|
|
|
is silently ignored, causing old programs to fail mysteriously.)
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B i
|
|
|
|
Matches an optionally signed integer; the next pointer must be a pointer to
|
|
|
|
.IR int .
|
2007-04-12 22:42:49 +00:00
|
|
|
The integer is read in base 16 if it begins with
|
2005-07-14 13:48:54 +00:00
|
|
|
.I 0x
|
2007-04-12 22:42:49 +00:00
|
|
|
or
|
|
|
|
.IR 0X ,
|
|
|
|
in base 8 if it begins with
|
|
|
|
.IR 0 ,
|
2005-07-14 13:48:54 +00:00
|
|
|
and in base 10 otherwise.
|
|
|
|
Only characters that correspond to the base are used.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B o
|
|
|
|
Matches an unsigned octal integer; the next pointer must be a pointer to
|
|
|
|
.IR "unsigned int" .
|
|
|
|
.TP
|
|
|
|
.B u
|
|
|
|
Matches an unsigned decimal integer; the next pointer must be a
|
|
|
|
pointer to
|
|
|
|
.IR "unsigned int" .
|
|
|
|
.TP
|
|
|
|
.B x
|
|
|
|
Matches an unsigned hexadecimal integer; the next pointer must
|
|
|
|
be a pointer to
|
|
|
|
.IR "unsigned int" .
|
|
|
|
.TP
|
|
|
|
.B X
|
|
|
|
Equivalent to
|
|
|
|
.BR x .
|
|
|
|
.TP
|
|
|
|
.B f
|
|
|
|
Matches an optionally signed floating-point number; the next pointer must
|
|
|
|
be a pointer to
|
|
|
|
.IR float .
|
|
|
|
.TP
|
|
|
|
.B e
|
|
|
|
Equivalent to
|
|
|
|
.BR f .
|
|
|
|
.TP
|
|
|
|
.B g
|
|
|
|
Equivalent to
|
|
|
|
.BR f .
|
|
|
|
.TP
|
|
|
|
.B E
|
|
|
|
Equivalent to
|
|
|
|
.BR f .
|
|
|
|
.TP
|
2005-07-14 13:48:54 +00:00
|
|
|
.B a
|
|
|
|
(C99) Equivalent to
|
|
|
|
.BR f .
|
|
|
|
.TP
|
2004-11-03 13:51:07 +00:00
|
|
|
.B s
|
2005-07-14 13:48:54 +00:00
|
|
|
Matches a sequence of non-white-space characters;
|
2015-12-04 19:05:17 +00:00
|
|
|
the next pointer must be a pointer to the initial element of a
|
|
|
|
character array that is long enough to hold the input sequence and
|
gets.3, mbtowc.3, printf.3, puts.3, scanf.3, stpcpy.3, stpncpy.3, strcat.3, strlen.3, strnlen.3, strsep.3, strstr.3, strxfrm.3, utmp.5: Global fix: consistent use of "null byte"
Bring more consistency to the discussion of
"[terminating] null byte"
by writing (at least in the initial use in a page)
"[terminating] null byte ('\0')".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 04:16:17 +00:00
|
|
|
the terminating null byte (\(aq\\0\(aq), which is added automatically.
|
2005-07-14 13:48:54 +00:00
|
|
|
The input string stops at white space or at the maximum field
|
2004-11-03 13:51:07 +00:00
|
|
|
width, whichever occurs first.
|
|
|
|
.TP
|
|
|
|
.B c
|
2005-07-14 13:48:54 +00:00
|
|
|
Matches a sequence of characters whose length is specified by the
|
|
|
|
.I maximum field width
|
|
|
|
(default 1); the next pointer must be a pointer to
|
2004-11-03 13:51:07 +00:00
|
|
|
.IR char ,
|
2013-05-19 17:10:58 +00:00
|
|
|
and there must be enough room for all the characters
|
|
|
|
(no terminating null byte is added).
|
2007-04-12 22:42:49 +00:00
|
|
|
The usual skip of leading white space is suppressed.
|
|
|
|
To skip white space first, use an explicit space in the format.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B \&[
|
mbind.2, rename.2, sched_setscheduler.2, set_mempolicy.2, syslog.2, argz_add.3, dlopen.3, scanf.3, strtod.3, strtok.3, tcgetpgrp.3, hd.4, cpuset.7, regex.7, ld.so.8: Global fix: s/non-empty/nonempty/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:41:47 +00:00
|
|
|
Matches a nonempty sequence of characters from the specified set of
|
2004-11-03 13:51:07 +00:00
|
|
|
accepted characters; the next pointer must be a pointer to
|
|
|
|
.IR char ,
|
|
|
|
and there must be enough room for all the characters in the string, plus a
|
2006-01-13 02:09:44 +00:00
|
|
|
terminating null byte.
|
2007-04-12 22:42:49 +00:00
|
|
|
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
|
2004-11-03 13:51:07 +00:00
|
|
|
.B [
|
|
|
|
character and a close bracket
|
|
|
|
.B ]
|
2007-04-12 22:42:49 +00:00
|
|
|
character.
|
|
|
|
The set
|
2004-11-03 13:51:07 +00:00
|
|
|
.I excludes
|
|
|
|
those characters if the first character after the open bracket is a
|
|
|
|
circumflex
|
2006-02-05 08:54:26 +00:00
|
|
|
.RB ( ^ ).
|
2004-11-03 13:51:07 +00:00
|
|
|
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
|
2005-07-07 08:27:03 +00:00
|
|
|
.B \-
|
2004-11-03 13:51:07 +00:00
|
|
|
is also special; when placed between two other characters, it adds all
|
2007-04-12 22:42:49 +00:00
|
|
|
intervening characters to the set.
|
|
|
|
To include a hyphen, make it the last
|
|
|
|
character before the final close bracket.
|
|
|
|
For instance,
|
2005-07-18 08:37:13 +00:00
|
|
|
.B [^]0\-9\-]
|
2005-07-14 13:48:54 +00:00
|
|
|
means
|
|
|
|
the set "everything except close bracket, zero through nine, and hyphen".
|
2004-11-03 13:51:07 +00:00
|
|
|
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.
|
|
|
|
.TP
|
|
|
|
.B p
|
2007-04-12 22:42:49 +00:00
|
|
|
Matches a pointer value (as printed by
|
2007-07-09 21:02:59 +00:00
|
|
|
.B %p
|
2005-07-14 13:48:54 +00:00
|
|
|
in
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR printf (3);
|
2005-06-17 13:06:58 +00:00
|
|
|
the next pointer must be a pointer to a pointer to
|
2004-11-03 13:51:07 +00:00
|
|
|
.IR void .
|
|
|
|
.TP
|
|
|
|
.B 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
|
|
|
|
.IR int .
|
|
|
|
This is
|
|
|
|
.I not
|
2015-05-04 12:44:49 +00:00
|
|
|
a conversion and does
|
|
|
|
.I not
|
|
|
|
increase the count returned by the function.
|
|
|
|
The assignment can be suppressed with the
|
2004-11-03 13:51:07 +00:00
|
|
|
.B *
|
2015-05-04 12:44:49 +00:00
|
|
|
assignment-suppression character, but the effect on the
|
|
|
|
return value is undefined.
|
|
|
|
Therefore
|
|
|
|
.B %*n
|
|
|
|
conversions should not be used.
|
getent.1, intro.1, time.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, exit_group.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, flock.2, fork.2, fstatat.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kill.2, killpg.2, link.2, linkat.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, migrate_pages.2, mincore.2, mkdir.2, mkdirat.2, mknod.2, mknodat.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, openat.2, outb.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pipe.2, pivot_root.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readlinkat.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, renameat.2, rmdir.2, rt_sigqueueinfo.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unlinkat.2, uselib.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, MB_CUR_MAX.3, MB_LEN_MAX.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, btree.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cerf.3, cexp.3, cexp2.3, cfree.3, cimag.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, dbopen.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getw.3, getwchar.3, glob.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, ilogb.3, index.3, inet.3, inet_ntop.3, inet_pton.3, infnan.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, ldexp.3, lgamma.3, lio_listio.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, longjmp.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, malloc.3, malloc_hook.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkfifoat.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, nextafter.3, nl_langinfo.3, offsetof.3, on_exit.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_kill_other_threads_np.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, queue.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scandirat.3, scanf.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console.4, console_codes.4, console_ioctl.4, dsp56k.4, fd.4, full.4, hd.4, hpsa.4, initrd.4, intro.4, lp.4, mem.4, mouse.4, null.4, pts.4, ram.4, random.4, rtc.4, sk98lin.4, st.4, tty.4, ttyS.4, tty_ioctl.4, vcs.4, wavelan.4, acct.5, charmap.5, dir_colors.5, filesystems.5, ftpusers.5, group.5, host.conf.5, hosts.5, hosts.equiv.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, passwd.5, proc.5, protocols.5, resolv.conf.5, rpc.5, securetty.5, services.5, shells.5, termcap.5, ttytype.5, utmp.5, armscii-8.7, arp.7, ascii.7, bootparam.7, capabilities.7, charsets.7, complex.7, cp1251.7, credentials.7, ddp.7, environ.7, epoll.7, fifo.7, futex.7, glob.7, hier.7, icmp.7, inotify.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, locale.7, mailaddr.7, man.7, mq_overview.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, posixoptions.7, pthreads.7, pty.7, raw.7, regex.7, rtld-audit.7, rtnetlink.7, sem_overview.7, shm_overview.7, sigevent.7, signal.7, socket.7, standards.7, suffixes.7, svipc.7, tcp.7, termio.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, nscd.8, sync.8, tzselect.8, zdump.8, zic.8: Global fix: remove unneeded double quotes in .SH headings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 18:01:36 +00:00
|
|
|
.SH RETURN VALUE
|
2015-12-27 15:00:29 +00:00
|
|
|
On success, these functions return the number of input items
|
|
|
|
successfully matched and assigned;
|
|
|
|
this can be fewer than provided for,
|
|
|
|
or even zero, in the event of an early matching failure.
|
2005-07-06 07:41:37 +00:00
|
|
|
|
|
|
|
The value
|
|
|
|
.B EOF
|
2007-04-12 22:42:49 +00:00
|
|
|
is returned if the end of input is reached before either the first
|
2006-02-05 08:57:26 +00:00
|
|
|
successful conversion or a matching failure occurs.
|
2004-11-03 13:51:07 +00:00
|
|
|
.B EOF
|
2007-04-12 22:42:49 +00:00
|
|
|
is also returned if a read error occurs,
|
2005-07-06 07:41:37 +00:00
|
|
|
in which case the error indicator for the stream (see
|
|
|
|
.BR ferror (3))
|
|
|
|
is set, and
|
|
|
|
.I errno
|
2015-05-06 12:53:30 +00:00
|
|
|
is set to indicate the error.
|
2008-06-22 08:35:24 +00:00
|
|
|
.SH ERRORS
|
2008-09-29 09:00:36 +00:00
|
|
|
.TP
|
2008-06-22 08:35:24 +00:00
|
|
|
.B EAGAIN
|
|
|
|
The file descriptor underlying
|
|
|
|
.I stream
|
accept.2, connect.2, eventfd.2, flock.2, open.2, posix_fadvise.2, read.2, recv.2, sched_setscheduler.2, select_tut.2, send.2, signalfd.2, splice.2, timerfd_create.2, write.2, flockfile.3, mkfifo.3, mq_notify.3, mq_open.3, pthread_tryjoin_np.3, scanf.3, random.4, ddp.7, epoll.7, fifo.7, ip.7, pipe.7, socket.7, spufs.7: Global fix: s/non-blocking/nonblocking/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:43:10 +00:00
|
|
|
is marked nonblocking, and the read operation would block.
|
2008-06-22 08:35:24 +00:00
|
|
|
.TP
|
|
|
|
.B EBADF
|
|
|
|
The file descriptor underlying
|
|
|
|
.I stream
|
|
|
|
is invalid, or not open for reading.
|
|
|
|
.TP
|
|
|
|
.B EILSEQ
|
|
|
|
Input byte sequence does not form a valid character.
|
|
|
|
.TP
|
|
|
|
.B EINTR
|
2008-07-07 04:40:49 +00:00
|
|
|
The read operation was interrupted by a signal; see
|
|
|
|
.BR signal (7).
|
2008-06-22 08:35:24 +00:00
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
Not enough arguments; or
|
|
|
|
.I format
|
|
|
|
is NULL.
|
|
|
|
.TP
|
|
|
|
.B ENOMEM
|
|
|
|
Out of memory.
|
|
|
|
.TP
|
|
|
|
.B ERANGE
|
|
|
|
The result of an integer conversion would exceed the size
|
|
|
|
that can be stored in the corresponding integer type.
|
2015-04-08 02:56:23 +00:00
|
|
|
.SH ATTRIBUTES
|
|
|
|
For an explanation of the terms used in this section, see
|
|
|
|
.BR attributes (7).
|
|
|
|
.TS
|
|
|
|
allbox;
|
|
|
|
lbw20 lb lb
|
|
|
|
l l l.
|
|
|
|
Interface Attribute Value
|
|
|
|
T{
|
|
|
|
.BR scanf (),
|
|
|
|
.BR fscanf (),
|
|
|
|
.br
|
|
|
|
.BR sscanf (),
|
|
|
|
.BR vscanf (),
|
|
|
|
.br
|
|
|
|
.BR vsscanf (),
|
|
|
|
.BR vfscanf ()
|
|
|
|
T} Thread safety MT-Safe locale
|
|
|
|
.TE
|
|
|
|
|
getent.1, intro.1, time.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, exit_group.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, flock.2, fork.2, fstatat.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kill.2, killpg.2, link.2, linkat.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, migrate_pages.2, mincore.2, mkdir.2, mkdirat.2, mknod.2, mknodat.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, openat.2, outb.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pipe.2, pivot_root.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readlinkat.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, renameat.2, rmdir.2, rt_sigqueueinfo.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unlinkat.2, uselib.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, MB_CUR_MAX.3, MB_LEN_MAX.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, btree.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cerf.3, cexp.3, cexp2.3, cfree.3, cimag.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, dbopen.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getw.3, getwchar.3, glob.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, ilogb.3, index.3, inet.3, inet_ntop.3, inet_pton.3, infnan.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, ldexp.3, lgamma.3, lio_listio.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, longjmp.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, malloc.3, malloc_hook.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkfifoat.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, nextafter.3, nl_langinfo.3, offsetof.3, on_exit.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_kill_other_threads_np.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, queue.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scandirat.3, scanf.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console.4, console_codes.4, console_ioctl.4, dsp56k.4, fd.4, full.4, hd.4, hpsa.4, initrd.4, intro.4, lp.4, mem.4, mouse.4, null.4, pts.4, ram.4, random.4, rtc.4, sk98lin.4, st.4, tty.4, ttyS.4, tty_ioctl.4, vcs.4, wavelan.4, acct.5, charmap.5, dir_colors.5, filesystems.5, ftpusers.5, group.5, host.conf.5, hosts.5, hosts.equiv.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, passwd.5, proc.5, protocols.5, resolv.conf.5, rpc.5, securetty.5, services.5, shells.5, termcap.5, ttytype.5, utmp.5, armscii-8.7, arp.7, ascii.7, bootparam.7, capabilities.7, charsets.7, complex.7, cp1251.7, credentials.7, ddp.7, environ.7, epoll.7, fifo.7, futex.7, glob.7, hier.7, icmp.7, inotify.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, locale.7, mailaddr.7, man.7, mq_overview.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, posixoptions.7, pthreads.7, pty.7, raw.7, regex.7, rtld-audit.7, rtnetlink.7, sem_overview.7, shm_overview.7, sigevent.7, signal.7, socket.7, standards.7, suffixes.7, svipc.7, tcp.7, termio.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, nscd.8, sync.8, tzselect.8, zdump.8, zic.8: Global fix: remove unneeded double quotes in .SH headings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 18:01:36 +00:00
|
|
|
.SH CONFORMING TO
|
2004-11-03 13:51:07 +00:00
|
|
|
The functions
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR fscanf (),
|
|
|
|
.BR scanf (),
|
2004-11-03 13:51:07 +00:00
|
|
|
and
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR sscanf ()
|
2008-07-01 14:29:33 +00:00
|
|
|
conform to C89 and C99 and POSIX.1-2001.
|
|
|
|
These standards do not specify the
|
2008-06-22 08:35:24 +00:00
|
|
|
.B ERANGE
|
|
|
|
error.
|
2004-11-03 13:51:07 +00:00
|
|
|
.PP
|
2007-04-12 22:42:49 +00:00
|
|
|
The
|
2004-11-03 13:51:07 +00:00
|
|
|
.B q
|
2007-04-12 22:42:49 +00:00
|
|
|
specifier is the 4.4BSD notation for
|
2004-11-03 13:51:07 +00:00
|
|
|
.IR "long long" ,
|
|
|
|
while
|
|
|
|
.B ll
|
|
|
|
or the usage of
|
|
|
|
.B L
|
|
|
|
in integer conversions is the GNU notation.
|
|
|
|
.PP
|
2007-04-12 22:42:49 +00:00
|
|
|
The Linux version of these functions is based on the
|
|
|
|
.I GNU
|
2004-11-03 13:51:07 +00:00
|
|
|
.I libio
|
2007-04-12 22:42:49 +00:00
|
|
|
library.
|
|
|
|
Take a look at the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I info
|
2007-04-12 22:42:49 +00:00
|
|
|
documentation of
|
2004-11-03 13:51:07 +00:00
|
|
|
.I GNU
|
|
|
|
.I libc (glibc-1.08)
|
2007-04-12 22:42:49 +00:00
|
|
|
for a more concise description.
|
2008-06-22 10:35:40 +00:00
|
|
|
.SH NOTES
|
2014-01-07 22:27:23 +00:00
|
|
|
.SS The 'a' assignment-allocation modifier
|
|
|
|
Originally, the GNU C library supported dynamic allocation for string inputs
|
2013-02-02 01:17:46 +00:00
|
|
|
(as a nonstandard extension) via the
|
2008-06-22 10:35:40 +00:00
|
|
|
.B a
|
2014-01-07 22:27:23 +00:00
|
|
|
character.
|
|
|
|
(This feature is present at least as far back as glibc 2.0.)
|
|
|
|
Thus, one could write the following to have
|
|
|
|
.BR scanf ()
|
|
|
|
allocate a buffer for an input string,
|
|
|
|
with a pointer to that buffer being returned in
|
|
|
|
.IR *buf :
|
|
|
|
|
|
|
|
char *buf;
|
|
|
|
scanf("%as", &buf);
|
|
|
|
.PP
|
|
|
|
The use of the letter
|
|
|
|
.B a
|
|
|
|
for this purpose was problematic, since
|
|
|
|
.B a
|
|
|
|
is also specified by the ISO C standard as a synonym for
|
|
|
|
.B f
|
|
|
|
(floating-point input).
|
|
|
|
POSIX.1-2008 instead specifies the
|
|
|
|
.B m
|
|
|
|
modifier for assignment allocation (as documented in DESCRIPTION, above).
|
2008-06-22 10:35:40 +00:00
|
|
|
.PP
|
2014-01-07 22:27:23 +00:00
|
|
|
Note that the
|
|
|
|
.B a
|
|
|
|
modifier is not available if the program is compiled with
|
2008-06-22 13:15:34 +00:00
|
|
|
.I "gcc -std=c99"
|
2008-06-22 10:35:40 +00:00
|
|
|
or
|
2008-06-22 13:15:34 +00:00
|
|
|
.IR "gcc -D_ISOC99_SOURCE"
|
2008-06-22 10:35:40 +00:00
|
|
|
(unless
|
|
|
|
.B _GNU_SOURCE
|
2008-06-22 13:15:34 +00:00
|
|
|
is also specified), in which case the
|
2008-06-22 10:35:40 +00:00
|
|
|
.B a
|
2008-07-23 02:57:20 +00:00
|
|
|
is interpreted as a specifier for floating-point numbers (see above).
|
2008-06-22 10:35:40 +00:00
|
|
|
|
2014-01-07 22:27:23 +00:00
|
|
|
Support for the
|
2008-06-22 10:35:40 +00:00
|
|
|
.B m
|
2014-01-07 22:27:23 +00:00
|
|
|
modifier was added to glibc starting with version 2.7,
|
|
|
|
and new programs should use that modifier instead of
|
|
|
|
.BR a .
|
|
|
|
|
|
|
|
As well as being standardized by POSIX, the
|
2008-06-22 10:35:40 +00:00
|
|
|
.B m
|
2014-01-07 22:27:23 +00:00
|
|
|
modifier has the following further advantages over
|
|
|
|
the use of
|
|
|
|
.BR a:
|
2008-06-22 10:35:40 +00:00
|
|
|
.IP * 2
|
|
|
|
It may also be applied to
|
|
|
|
.B %c
|
|
|
|
conversion specifiers (e.g.,
|
|
|
|
.BR %3mc ).
|
|
|
|
.IP *
|
|
|
|
It avoids ambiguity with respect to the
|
|
|
|
.B %a
|
|
|
|
floating-point conversion specifier (and is unaffected by
|
2008-06-22 13:15:34 +00:00
|
|
|
.IR "gcc -std=c99"
|
2014-01-07 22:27:23 +00:00
|
|
|
etc.).
|
2008-08-05 16:42:24 +00:00
|
|
|
.SH BUGS
|
|
|
|
All functions are fully C89 conformant, but provide the
|
|
|
|
additional specifiers
|
|
|
|
.B q
|
|
|
|
and
|
|
|
|
.B a
|
|
|
|
as well as an additional behavior of the
|
|
|
|
.B L
|
|
|
|
and
|
|
|
|
.B l
|
|
|
|
specifiers.
|
|
|
|
The latter may be considered to be a bug, as it changes the
|
|
|
|
behavior of specifiers defined in C89.
|
|
|
|
.PP
|
|
|
|
Some combinations of the type modifiers and conversion
|
|
|
|
specifiers defined by ANSI C do not make sense
|
2012-05-06 19:25:59 +00:00
|
|
|
(e.g.,
|
2008-08-05 16:42:24 +00:00
|
|
|
.BR "%Ld" ).
|
|
|
|
While they may have a well-defined behavior on Linux, this need not
|
|
|
|
to be so on other architectures.
|
|
|
|
Therefore it usually is better to use
|
|
|
|
modifiers that are not defined by ANSI C at all, that is, use
|
|
|
|
.B q
|
|
|
|
instead of
|
|
|
|
.B L
|
|
|
|
in combination with
|
|
|
|
\fBd\fP, \fBi\fP, \fBo\fP, \fBu\fP, \fBx\fP, and \fBX\fP
|
|
|
|
conversions or
|
|
|
|
.BR ll .
|
|
|
|
.PP
|
|
|
|
The usage of
|
|
|
|
.B q
|
|
|
|
is not the same as on 4.4BSD,
|
|
|
|
as it may be used in float conversions equivalently to
|
|
|
|
.BR L .
|
getrlimit.2, setgid.2, timerfd_create.2, wait.2, getenv.3, if_nameindex.3, scanf.3, aio.7, numa.7, rtld-audit.7, udplite.7: Fix order of SH sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 10:49:39 +00:00
|
|
|
.SH EXAMPLE
|
|
|
|
To use the dynamic allocation conversion specifier, specify
|
|
|
|
.B m
|
|
|
|
as a length modifier (thus
|
|
|
|
.B %ms
|
|
|
|
or
|
|
|
|
\fB%m[\fP\fIrange\fP\fB]\fP).
|
|
|
|
The caller must
|
|
|
|
.BR free (3)
|
|
|
|
the returned string, as in the following example:
|
|
|
|
.in +4n
|
|
|
|
.nf
|
|
|
|
|
|
|
|
char *p;
|
|
|
|
int n;
|
|
|
|
|
|
|
|
errno = 0;
|
|
|
|
n = scanf("%m[a-z]", &p);
|
|
|
|
if (n == 1) {
|
|
|
|
printf("read: %s\\n", p);
|
|
|
|
free(p);
|
|
|
|
} else if (errno != 0) {
|
|
|
|
perror("scanf");
|
|
|
|
} else {
|
|
|
|
fprintf(stderr, "No matching characters\\n");
|
|
|
|
}
|
|
|
|
.fi
|
|
|
|
.in
|
|
|
|
.PP
|
intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-31 08:53:00 +00:00
|
|
|
As shown in the above example, it is necessary to call
|
getrlimit.2, setgid.2, timerfd_create.2, wait.2, getenv.3, if_nameindex.3, scanf.3, aio.7, numa.7, rtld-audit.7, udplite.7: Fix order of SH sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 10:49:39 +00:00
|
|
|
.BR free (3)
|
intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-31 08:53:00 +00:00
|
|
|
only if the
|
getrlimit.2, setgid.2, timerfd_create.2, wait.2, getenv.3, if_nameindex.3, scanf.3, aio.7, numa.7, rtld-audit.7, udplite.7: Fix order of SH sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 10:49:39 +00:00
|
|
|
.BR scanf ()
|
|
|
|
call successfully read a string.
|
getent.1, intro.1, time.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, exit_group.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, flock.2, fork.2, fstatat.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kill.2, killpg.2, link.2, linkat.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, migrate_pages.2, mincore.2, mkdir.2, mkdirat.2, mknod.2, mknodat.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, openat.2, outb.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pipe.2, pivot_root.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readlinkat.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, renameat.2, rmdir.2, rt_sigqueueinfo.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unlinkat.2, uselib.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, MB_CUR_MAX.3, MB_LEN_MAX.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, btree.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cerf.3, cexp.3, cexp2.3, cfree.3, cimag.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, dbopen.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getw.3, getwchar.3, glob.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, ilogb.3, index.3, inet.3, inet_ntop.3, inet_pton.3, infnan.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, ldexp.3, lgamma.3, lio_listio.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, longjmp.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, malloc.3, malloc_hook.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkfifoat.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, nextafter.3, nl_langinfo.3, offsetof.3, on_exit.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_kill_other_threads_np.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, queue.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scandirat.3, scanf.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console.4, console_codes.4, console_ioctl.4, dsp56k.4, fd.4, full.4, hd.4, hpsa.4, initrd.4, intro.4, lp.4, mem.4, mouse.4, null.4, pts.4, ram.4, random.4, rtc.4, sk98lin.4, st.4, tty.4, ttyS.4, tty_ioctl.4, vcs.4, wavelan.4, acct.5, charmap.5, dir_colors.5, filesystems.5, ftpusers.5, group.5, host.conf.5, hosts.5, hosts.equiv.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, passwd.5, proc.5, protocols.5, resolv.conf.5, rpc.5, securetty.5, services.5, shells.5, termcap.5, ttytype.5, utmp.5, armscii-8.7, arp.7, ascii.7, bootparam.7, capabilities.7, charsets.7, complex.7, cp1251.7, credentials.7, ddp.7, environ.7, epoll.7, fifo.7, futex.7, glob.7, hier.7, icmp.7, inotify.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, locale.7, mailaddr.7, man.7, mq_overview.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, posixoptions.7, pthreads.7, pty.7, raw.7, regex.7, rtld-audit.7, rtnetlink.7, sem_overview.7, shm_overview.7, sigevent.7, signal.7, socket.7, standards.7, suffixes.7, svipc.7, tcp.7, termio.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, nscd.8, sync.8, tzselect.8, zdump.8, zic.8: Global fix: remove unneeded double quotes in .SH headings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 18:01:36 +00:00
|
|
|
.SH SEE ALSO
|
2007-05-16 18:25:50 +00:00
|
|
|
.BR getc (3),
|
|
|
|
.BR printf (3),
|
|
|
|
.BR setlocale (3),
|
|
|
|
.BR strtod (3),
|
|
|
|
.BR strtol (3),
|
|
|
|
.BR strtoul (3)
|