libzahl

big integer library
git clone git://git.suckless.org/libzahl
Log | Files | Refs | README | LICENSE

zsets.3 (786B)


      1 .TH ZSETS 3 libzahl
      2 .SH NAME
      3 zsets - Parses a string to a big integer
      4 .SH SYNOPSIS
      5 .nf
      6 #include <zahl.h>
      7 
      8 int zsets(z_t \fIa\fP, const char *\fIstr\fP);
      9 .fi
     10 .SH DESCRIPTION
     11 .B zsets
     12 parses the string
     13 .I str
     14 and stores the value in
     15 .IR a .
     16 .I a
     17 must already be initialized with
     18 .BR zinit (3).
     19 .I b
     20 must be a decimal integer. It may be
     21 prefixed with at most one ASCII minus
     22 sign or plus sign.
     23 .SH RETURN VALUE
     24 Upon successful completion, 0 is returned.
     25 On error -1 is returned an errno is appropriately.
     26 .SH ERRORS
     27 This function fails if:
     28 .TP
     29 .B EINVAL
     30 .B str
     31 is not a valid decimal ASCII integer.
     32 .P
     33 On other errors, the function performs a long jump
     34 using the jump buffer provided via
     35 .BR zsetup (3).
     36 .SH SEE ALSO
     37 .BR zset (3),
     38 .BR zsetu (3),
     39 .BR zseti (3),
     40 .BR zsave (3),
     41 .BR zstr (3)