HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

f
fwscanf(3C) fwscanf(3C)
s Matches a sequence of non white-space wide-characters. If no
l (ell) qualifier is present,
characters from the input field are converted as if by repeated calls to the
wcrtomb()
function, with the conversion state described by an mbstate_t object initialized to zero
before the first wide-character is converted. The corresponding argument must be a
pointer to a character array large enough to accept the sequence and the terminating null
character, which will be added automatically.
Otherwise, the corresponding argument must be a pointer to an array of wchar_t large enough to accept
the sequence and the terminating null wide-character, which will be added automatically.
[ Matches a non-empty sequence of wide-characters from a set of expected wide-characters
(the scanset). If no l (ell) qualifier is present, wide-characters from the input field are
converted as if by repeated calls to the
wcrtomb() function, with the conversion state
described by an mbstate_t object initialized to zero before the first wide-character is con-
verted. The corresponding argument must be a pointer to a character array large enough
to accept the sequence and the terminating null character, which will be added automati-
cally.
If an
l (ell) qualifier is present, the corresponding argument must be a pointer to an array of wchar_t
large enough to accept the sequence and the terminating null wide-character, which will be added
automatically.
The conversion specification includes all subsequent wide characters in the format string up to and
including the matching right square bracket (
]). The wide-characters between the square brackets (the
scanlist) comprise the scanset, unless the wide-character after the left square bracket is a circumflex (
ˆ),
in which case the scanset contains all wide-characters that do not appear in the scanlist between the
circumflex and the right square bracket. If the conversion specification begins with
[]
or [ˆ], the right
square bracket is included in the scanlist and the next right square bracket is the matching right square
bracket that ends the conversion specification; otherwise the first right square bracket is the one that
ends the conversion specification. If a
- is in the scanlist and is not the first wide-character, nor the
second where the first wide-character is a
ˆ, nor the last wide-character, the behavior is implementation-
dependent.
c Matches a sequence of wide-characters of the number specified by the field width (1 if no
field width is present in the conversion specification). If no
l (ell) qualifier is present,
wide-characters from the input field are converted as if by repeated calls to the
wcrtomb() function, with the conversion state described by an mbstate_t object initial-
ized to zero before the first wide-character is converted. The corresponding argument
must be a pointer to a character array large enough to accept the sequence. No null
character is added. Otherwise, the corresponding argument must be a pointer to an
array of wchar_t large enough to accept the sequence. No null wide-character is added.
p Matches an implementation-dependent set of sequences, which must be the same as the
set of sequences that is produced by the %p conversion of the corresponding
fwprintf() functions. The corresponding argument must be a pointer to a pointer to
void. If the input item is a value converted earlier during the same program execution,
the pointer that results will compare equal to that value; otherwise the behavior of the
%p conversion is undefined.
n No input is consumed. The corresponding argument must be a pointer to the integer into
which is to be written the number of wide-characters read from the input so far by this
call to the fwscanf() functions. Execution of a %n conversion specification does not
increment the assignment count returned at the completion of execution of the function.
C Same as lc.
S Same as
ls.
% Matches a sigle %; no conversion or assignment occurs. The complete conversion
specification must be %%.
If a conversion specification is invalid, the behavior is undefined.
The conversion characters
E, G and X are also valid and behave the same as, respectively, e, g and x.
If end-of-file is encountered during input, conversion is terminated. If end-of-file occurs before any wide-
characters matching the current conversion specification (except for
%n) have been read (other than lead-
ing white-space, where permitted), execution of the current conversion specification terminates with an
input failure. Otherwise, unless execution of the current conversion specification is terminated with a
Section 3−−336 Hewlett-Packard Company − 3 − HP-UX 11i Version 2: August 2003