The fwprintf_s function prints formatted output to a wide stream.
- Note
- POSIX specifies that
errno is set on error. However, the safeclib extended ES* errors do not set errno, only when the underlying system vfwprintf call fails, errno is set.
- Parameters
-
| [in] | stream | output wide stream to write to |
| [in] | fmt | format-control wide string. |
| [in] | ... | optional arguments |
- Precondition
- fmt shall not 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.
- Returns
- On success the total number of wide characters written is returned.
-
On failure a negative number is returned, and possibly errno set to EINVAL or EOVERFLOW.
- Return values
-
| -ESNULLP | when fmt is NULL pointer |
| -EINVAL | when fmt contains n |
| -1 | some other error. errno: EINVAL or EOVERFLOW |
- See also
- vwfprintf_s(), wprintf_s()