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)