zsets.3 - libzahl - big integer library
 (HTM) git clone git://git.suckless.org/libzahl
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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)