zsets.3 - 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) |