The vswscanf_s function reads a formatted wide string.
Reaching the end of the string is equivalent to reaching the end-of-file condition for fwscanf
.
- Parameters
-
[in] | src | pointer to a null-terminated wide string to read from |
[in] | fmt | format-control wide string. |
[in] | ap | arguments to write to |
- Precondition
- Neither
src
nor fmt
shall be a null pointer.
-
fmt
shall not contain the conversion specifier n
-
None of the arguments corresponding to
s
is a null pointer. (not yet)
-
No encoding error shall occur.
-
c
, s
, and %
[ conversion specifiers each expect two arguments (the usual pointer and a value of type rsize_t
indicating the size of the receiving array, which may be 1 when reading with a lc
into a single wide character) and except that the following errors are detected at runtime and call the currently installed constraint handler function. (not yet)
- Warning
- The current implementation just does some basic argument checks and then calls the native
vsscanf()
libc function. Thus the s
null pointer check and the two-arg versions of c
, s
, and %
[ are not yet implemented.
- Returns
- Number of receiving arguments successfully assigned, or
EOF
if read failure occurs before the first receiving argument was assigned or if there is a runtime constraint violation.
- Return values
-
> | 0 on success, the number of arguments assigned |
EOF | on error |
- See also
- vswscanf_s(), snwprintf_s(), vsnprintf_s()