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

FreeBSD Manual Pages

  
 
  

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

NAME
       explain_strtoull_or_die - convert string	to integer and report errors

SYNOPSIS
       #include	<libexplain/strtoull.h>
       unsigned	 long  long  explain_strtoull_or_die(const  char  *nptr,  char
       **endptr, int base);
       unsigned	long long  explain_strtoull_on_error(const  char  *nptr,  char
       **endptr, int base))

DESCRIPTION
       The  explain_strtoull_or_die  function  is used to call the strtoull(3)
       system call. On failure an explanation will be printed to  stderr,  ob-
       tained from the explain_strtoull(3) function, and then the process ter-
       minates by calling exit(EXIT_FAILURE).

       The  explain_strtoull_on_error function is used to call the strtoull(3)
       system call. On failure an explanation will be printed to  stderr,  ob-
       tained  from the	explain_strtoull(3) function, but still	returns	to the
       caller.

       nptr    The nptr, exactly as to be passed  to  the  strtoull(3)	system
	       call.

       endptr  The  endptr,  exactly as	to be passed to	the strtoull(3)	system
	       call.

       base    The base, exactly as to be passed  to  the  strtoull(3)	system
	       call.

RETURN VALUE
       The  explain_strtoull_or_die function only returns on success, see str-
       toull(3)	for more information. On failure, prints  an  explanation  and
       exits, it does not return.

       The  explain_strtoull_on_error function always returns the value	return
       by the wrapped strtoull(3) system call.

EXAMPLE
       The explain_strtoull_or_die function is intended	to be used in a	 fash-
       ion similar to the following example:
	      unsigned long long result	= explain_strtoull_or_die(nptr,	endptr,	base);

SEE ALSO
       strtoull(3)
	       convert a string	to an unsigned long integer

       explain_strtoull(3)
	       explain strtoull(3) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2009 Peter	Miller

						    explain_strtoull_or_die(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=explain_strtoull_or_die&sektion=3&manpath=FreeBSD+Ports+15.0.quarterly>

home | help