diff options
| -rw-r--r-- | include/stdio.h | 518 | ||||
| -rw-r--r-- | src/stdio/scanf.c | 641 |
2 files changed, 1159 insertions, 0 deletions
diff --git a/include/stdio.h b/include/stdio.h index 419ba5a..0929fd5 100644 --- a/include/stdio.h +++ b/include/stdio.h @@ -864,5 +864,523 @@ int vbwprintf(wchar_t** restrict, size_t* restrict, size_t, int, const wchar_t* +/** + * This function is identical to `fscanf` with + * `stdout` as the first argument. + * + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int scanf(const char* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1), format(slibc_scanf, 1, 2)))); + +/** + * Parse data from from a text stream. + * + * TODO list format rules for fscanf + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fscanf(FILE* restrict, const char* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2), format(slibc_scanf, 2, 3)))); + +/** + * This function is identical to `fscanf`, + * except it reads from a string rather than + * a file. + * + * @param input The formatted string. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int sscanf(const char* restrict, const char* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2), format(slibc_scanf, 2, 3)))); + +#if defined (_SLIBC_SOURCE) && !defined(__PORTABLE) +/** + * This function is identical to `fscanf`, + * except it does not lock the stream. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fscanf_unlocked(FILE* restrict, const char* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2), format(slibc_scanf, 2, 3)))); + +/** + * This function is identical to `scanf`, + * except it will stop parsing the string + * after a selected number of bytes, or + * at the end of the string. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of bytes to read. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int snscanf(const char* restrict, size_t, const char* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(3), format(slibc_scanf, 3, 4)))); + +/** + * This function is identical to `fscanf`, + * except it is limited to file descriptor-backed + * streams, and uses the file descriptor as the + * first argument rather than the stream. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int dscanf(int, const char* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(2), format(slibc_scanf, 2, 3)))); +#endif + + +/** + * This function is identical to `scanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vscanf(const char* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1)))); + +/** + * This function is identical to `fscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfscanf(FILE* restrict, const char* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `sscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param input The formatted string. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vsscanf(const char* restrict, const char* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +#if defined (_SLIBC_SOURCE) && !defined(__PORTABLE) +/** + * This function is identical to `fscanf_unlocked`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfscanf_unlocked(FILE* restrict, const char* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `snscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of bytes to read. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vsnscanf(const char* restrict, size_t, const char* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(3)))); + +/** + * This function is identical to `sscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vdscanf(int, const char* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(2)))); +#endif + + +/** + * This function is identical to `scanf`, + * except it uses `wchar_t` instead of `char`. + * + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int wscanf(const wchar_t* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1)))); + +/** + * This function is identical to `fscanf`, + * except it uses `wchar_t` instead of `char`. + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fwscanf(FILE* restrict, const wchar_t* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `sscanf`, + * except it uses `wchar_t` instead of `char`. + * + * @param input The formatted string. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int swscanf(const wchar_t* restrict, const wchar_t* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +#if defined (_SLIBC_SOURCE) && !defined(__PORTABLE) +/** + * This function is identical to `fscanf_unlocked`, + * except it uses `wchar_t` instead of `char`. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fwscanf_unlocked(FILE* restrict, const wchar_t* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `snscanf`, + * except it uses `wchar_t` instead of `char`. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of characters to read. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int snwscanf(const wchar_t* restrict, size_t, const wchar_t* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(3)))); + +/** + * This function is identical to `dscanf`, + * except it uses `wchar_t` instead of `char`. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int dwscanf(int, const wchar_t* restrict, ...) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(2)))); +#endif + + +/** + * This function is identical to `wscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vwscanf(const wchar_t* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1)))); + +/** + * This function is identical to `fwscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfwscanf(FILE* restrict, const wchar_t* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `swscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param input The formatted string. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vswscanf(const wchar_t* restrict, const wchar_t* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +#if defined (_SLIBC_SOURCE) && !defined(__PORTABLE) +/** + * This function is identical to `fwscanf_unlocked`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfwscanf_unlocked(FILE* restrict, const wchar_t* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `snwscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of characters to read. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vsnwscanf(const wchar_t* restrict, size_t, const wchar_t* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(3)))); + +/** + * This function is identical to `swscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vdwscanf(int, const wchar_t* restrict, va_list) + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(2)))); +#endif + + + +#if !defined(__PORTABLE_SOURCE) +/** + * This function is identical to `scanf`. + */ +int __isoc99_scanf(const char* restrict, ...) + __deprecated("Use 'scanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1), format(slibc_scanf, 1, 2)))); + +/** + * This function is identical to `fscanf`. + */ +int __isoc99_fscanf(FILE* restrict, const char* restrict, ...) + __deprecated("Use 'fscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2), format(slibc_scanf, 2, 3)))); + +/** + * This function is identical to `sscanf`. + */ +int __isoc99_sscanf(const char* restrict, const char* restrict, ...) + __deprecated("Use 'sscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2), format(slibc_scanf, 2, 3)))); + + +/** + * This function is identical to `vscanf`. + */ +int __isoc99_vscanf(const char* restrict, va_list) + __deprecated("Use 'vscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1)))); + +/** + * This function is identical to `vfscanf`. + */ +int __isoc99_vfscanf(FILE* restrict, const char* restrict, va_list) + __deprecated("Use 'vfscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `vsscanf`. + */ +int __isoc99_vsscanf(const char* restrict, const char* restrict, va_list) + __deprecated("Use 'vsscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + + +/** + * This function is identical to `wscanf`. + */ +int __isoc99_wscanf(const wchar_t* restrict, ...) + __deprecated("Use 'wscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1)))); + +/** + * This function is identical to `fwscanf`. + */ +int __isoc99_fwscanf(FILE* restrict, const wchar_t* restrict, ...) + __deprecated("Use 'fwscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `swscanf`. + */ +int __isoc99_swscanf(const wchar_t* restrict, const wchar_t* restrict, ...) + __deprecated("Use 'swscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + + +/** + * This function is identical to `vwscanf`. + */ +int __isoc99_vwscanf(const wchar_t* restrict, va_list) + __deprecated("Use 'vwscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1)))); + +/** + * This function is identical to `vfwscanf`. + */ +int __isoc99_vfwscanf(FILE* restrict, const wchar_t* restrict, va_list) + __deprecated("Use 'vfwscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); + +/** + * This function is identical to `vswscanf`. + */ +int __isoc99_vswscanf(const wchar_t* restrict, const wchar_t* restrict, va_list) + __deprecated("Use 'vswscanf' instead.") + __GCC_ONLY(__attribute__((warn_unused_result, nonnull(1, 2)))); +#endif + + + #endif diff --git a/src/stdio/scanf.c b/src/stdio/scanf.c new file mode 100644 index 0000000..446a38d --- /dev/null +++ b/src/stdio/scanf.c @@ -0,0 +1,641 @@ +/** + * slibc — Yet another C library + * Copyright © 2015 Mattias Andrée (maandree@member.fsf.org) + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see <http://www.gnu.org/licenses/>. + */ +#include <stdio.h> +#include <stdarg.h> +#include <errno.h> +#include <inttypes.h> +#include <unistd.h> +#include <string.h> +#include <wchar.h> +/* #include <slibc-scan.h> */ + + +#define V(C) \ + int r; \ + va_list args; \ + va_start(args, format); \ + r = v##C; \ + va_end(args); \ + return r + +#define S_CHAR(UNDERLAYING, MAXIMUM, LIMITED, DATA) \ + return vgeneric_scanf((generic_scanf_read_func_t)UNDERLAYING, NULL, \ + MAXIMUM, LIMITED, NULL, DATA, format, data) + +#define S_WCHAR(UNDERLAYING, MAXIMUM, LIMITED, DATA) \ + return vgeneric_wscanf((generic_wscanf_read_func_t)UNDERLAYING, NULL, \ + MAXIMUM, LIMITED, NULL, DATA, format, data) + +#define FLOCK(F) /* TODO lock stream */ +#define FUNLOCK(F) /* TODO unlock stream */ + + + +/** + * This function is identical to `fscanf` with + * `stdout` as the first argument. + * + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int scanf(const char* restrict format, ...) +{ + V(scanf(format, args)); +} + + +/** + * Parse data from from a text stream. + * + * TODO list format rules for fscanf + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fscanf(FILE* restrict stream, const char* restrict format, ...) +{ + V(fscanf(stream, format, args)); +} + + +/** + * This function is identical to `fscanf`, + * except it reads from a string rather than + * a file. + * + * @param input The formatted string. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int sscanf(const char* restrict input, const char* restrict format, ...) +{ + V(sscanf(input, format, args)); +} + + +/** + * This function is identical to `fscanf`, + * except it does not lock the stream. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fscanf_unlocked(FILE* restrict stream, const char* restrict format, ...) +{ + V(fscanf_unlocked(stream, format, args)); +} + + +/** + * This function is identical to `scanf`, + * except it will stop parsing the string + * after a selected number of bytes, or + * at the end of the string. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of bytes to read. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int snscanf(const char* restrict input, size_t length, const char* restrict format, ...) +{ + V(snscanf(input, length, format, args)); +} + + +/** + * This function is identical to `fscanf`, + * except it is limited to file descriptor-backed + * streams, and uses the file descriptor as the + * first argument rather than the stream. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int dscanf(int fd, const char* restrict format, ...) +{ + V(dscanf(fd, format, args)); +} + + +/** + * This function is identical to `scanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vscanf(const char* restrict format, va_list args) +{ + return vscanf(stdout, format, args); +} + + +/** + * This function is identical to `fscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfscanf(FILE* restrict stream, const char* restrict format, va_list args) +{ + int r, saved_errno; + FLOCK(stream); + r = vfscanf_unlocked(stream, format, args); + saved_errno = errno; + FUNLOCK(stream); + return errno = saved_errno, r; +} + + +/** + * This function is identical to `sscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param input The formatted string. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vsscanf(const char* restrict input, const char* restrict format, va_list args) +{ + S_CHAR(read_string, 0, 0, input); +} + + +/** + * This function is identical to `fscanf_unlocked`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfscanf_unlocked(FILE* restrict stream, const char* restrict format, va_list args) +{ + S_CHAR(read_stream, 0, 0, stream); +} + + +/** + * This function is identical to `snscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of bytes to read. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vsnscanf(const char* restrict input, size_t length, const char* restrict format, va_list args) +{ + S_CHAR(read_string, length, 1, input); +} + + +/** + * This function is identical to `sscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vdscanf(int fd, const char* restrict format, va_list args) +{ + S_CHAR(read_fd, 0, 0, &fd); +} + + +/** + * This function is identical to `scanf`, + * except it uses `wchar_t` instead of `char`. + * + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int wscanf(const wchar_t* restrict format, ...) +{ + V(wscanf(format, args)); +} + + +/** + * This function is identical to `fscanf`, + * except it uses `wchar_t` instead of `char`. + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fwscanf(FILE* restrict stream, const wchar_t* restrict format, ...) +{ + V(fwscanf(stream, format, args)); +} + + +/** + * This function is identical to `sscanf`, + * except it uses `wchar_t` instead of `char`. + * + * @param input The formatted string. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int swscanf(const wchar_t* restrict input, const wchar_t* restrict format, ...) +{ + V(swscanf(input, format, args)); +} + + +/** + * This function is identical to `fscanf_unlocked`, + * except it uses `wchar_t` instead of `char`. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int fwscanf_unlocked(FILE* restrict stream, const wchar_t* restrict format, ...) +{ + V(fwscanf_unlocked(stream, format, args)); +} + + +/** + * This function is identical to `snscanf`, + * except it uses `wchar_t` instead of `char`. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of characters to read. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int snwscanf(const wchar_t* restrict input, size_t length, const wchar_t* restrict format, ...) +{ + V(snscanf(input, length, format, args)); +} + + +/** + * This function is identical to `dscanf`, + * except it uses `wchar_t` instead of `char`. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param ... The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int dwscanf(int fd, const wchar_t* restrict format, ...) +{ + V(dwscanf(fd, format, args)); +} + + +/** + * This function is identical to `wscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vwscanf(const wchar_t* restrict format, va_list args) +{ + return vwscanf(stdout, format, args); +} + + +/** + * This function is identical to `fwscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfwscanf(FILE* restrict stream, const wchar_t* restrict format, va_list args) +{ + int r, saved_errno; + FLOCK(stream); + r = vfwscanf_unlocked(stream, format, args); + saved_errno = errno; + FUNLOCK(stream); + return errno = saved_errno, r; +} + + +/** + * This function is identical to `swscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * @param input The formatted string. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vswscanf(const wchar_t* restrict input, const wchar_t* restrict format, va_list args) +{ + S_WCHAR(wread_string, 0, 0, input); +} + + +/** + * This function is identical to `fwscanf_unlocked`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param stream The input stream. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vfwscanf_unlocked(FILE* restrict stream, const wchar_t* restrict format, va_list args) +{ + S_WCHAR(wread_stream, 0, 0, stream); +} + + +/** + * This function is identical to `snwscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param input The formatted string. + * @param length The maximum number of characters to read. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vsnwscanf(const wchar_t* restrict input, size_t length, const wchar_t* restrict format, va_list args) +{ + S_WCHAR(wread_string, length, 1, input); +} + + +/** + * This function is identical to `swscanf`, + * except it uses `va_list` instead of variadic arguments. + * + * This is a slibc extension. + * + * @param fd The file descriptor. + * @param format The format of the string. + * @param args The output parameter for the encoded values. + * @return The number successfully converted argument + * (may be less than specified.) `EOF` is returned + * if the end of the input is reached before the + * first argument is successfully converted, or + * on error. + */ +int vdwscanf(int fd, const wchar_t* restrict format, va_list args) +{ + S_WCHAR(wread_fd, 0, 0, &fd); +} + + + +/** + * This function is identical to `scanf`. + */ +int __isoc99_scanf(const char* restrict format, ...) +{ + V(scanf(format, args)); +} + +/** + * This function is identical to `fscanf`. + */ +int __isoc99_fscanf(FILE* restrict stream, const char* restrict format, ...) +{ + V(fscanf(stream, format, args)); +} + +/** + * This function is identical to `sscanf`. + */ +int __isoc99_sscanf(const char* restrict input, const char* restrict format, ...) +{ + V(sscanf(input, format, args)); +} + +/** + * This function is identical to `vscanf`. + */ +int __isoc99_vscanf(const char* restrict format, va_list args) +{ + return vscanf(format, args); +} + +/** + * This function is identical to `vfscanf`. + */ +int __isoc99_vfscanf(FILE* restrict stream, const char* restrict format, va_list args) +{ + return vfscanf(stream, format, args); +} + +/** + * This function is identical to `vsscanf`. + */ +int __isoc99_vsscanf(const char* restrict input, const char* restrict format, va_list args) +{ + return vsscanf(input, format, args); +} + +/** + * This function is identical to `wscanf`. + */ +int __isoc99_wscanf(const wchar_t* restrict format, ...) +{ + V(wscanf(format, args)); +} + +/** + * This function is identical to `fwscanf`. + */ +int __isoc99_fwscanf(FILE* restrict stream, const wchar_t* restrict format, ...) +{ + V(fwscanf(stream, format, args)); +} + +/** + * This function is identical to `swscanf`. + */ +int __isoc99_swscanf(const wchar_t* restrict input, const wchar_t* restrict format, ...) +{ + V(swscanf(input, format, args)); +} + +/** + * This function is identical to `vwscanf`. + */ +int __isoc99_vwscanf(const wchar_t* restrict format, va_list args) +{ + return vwscanf(format, args); +} + +/** + * This function is identical to `vfwscanf`. + */ +int __isoc99_vfwscanf(FILE* restrict stream, const wchar_t* restrict format, va_list args) +{ + return vfwscanf(stream, format, args); +} + +/** + * This function is identical to `vswscanf`. + */ +int __isoc99_vswscanf(const wchar_t* restrict input, const wchar_t* restrict format, va_list args) +{ + return vswscanf(input, format, args); +} + |