FreeBSD Manual Pages
scan_ulong(3) Library Functions Manual scan_ulong(3) NAME scan_ulong - parse an unsigned long integer in decimal ASCII represen- tation SYNTAX #include <libowfat/scan.h> size_t scan_ulong(const char *src,unsigned long *dest); DESCRIPTION scan_ulong parses an unsigned long integer in decimal ASCII representa- tion from src and writes the result into dest. It returns the number of bytes read from src. Leading + or - or space (or anything outside of 0-9) is not accepted. The libc conventions of "023" for octal or "0x23" for hexadecimal are not supported. scan_ulong will abort the scan if the next character is not a digit, or if it is a digit but adding it to the number would lead to an integer overflow. RETURN VALUE scan_ulong returns the number of characters successfully scanned and processed from src. EXAMPLES scan_ulong("23",&i) -> i=23, return 2 scan_ulong("+23",&i) -> return 0 scan_ulong("-23",&i) -> return 0 scan_ulong(" 23",&i) -> return 0 scan_ulong("23,42",&i) -> i=23, return 2 scan_ulong("023",&i) -> i=23, return 3 scan_ulong("0x23",&i) -> i=0, return 1 scan_ulong("4294967296",&i") -> i=429496729, return 9 // 32-bit system SEE ALSO scan_xlong(3), scan_8long(3), fmt_ulong(3) scan_ulong(3)
NAME | SYNTAX | DESCRIPTION | RETURN VALUE | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libowfat_scan_ulong&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>