Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
scan_ulong(3)		    Library Functions Manual		   scan_ulong(3)

NAME
     scan_ulong - parse an unsigned long integer in decimal ASCII representation

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 representation
     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  sup-
     ported.

     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  over-
     flow.

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)

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+15.1.quarterly>

home | help