zstr.3 - libzahl - big integer library | |
git clone git://git.suckless.org/libzahl | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
zstr.3 (776B) | |
--- | |
1 .TH ZSTR 3 libzahl | |
2 .SH NAME | |
3 zstr - Create a string representation of a big integer | |
4 .SH SYNOPSIS | |
5 .nf | |
6 #include <zahl.h> | |
7 | |
8 char *zstr(z_t \fIa\fP, char *\fIstr\fP, size_t \fIn\fP); | |
9 .fi | |
10 .SH DESCRIPTION | |
11 .B zstr | |
12 writes the integer | |
13 .I a | |
14 in decimal form into | |
15 .IR str . | |
16 If | |
17 .I str | |
18 is is | |
19 .BR 0 , | |
20 .B zstr | |
21 create a new allocation. | |
22 .P | |
23 .I n | |
24 must be either be zero or a value at least | |
25 as great as the length of the resulting string. | |
26 If both | |
27 .I n | |
28 and | |
29 .I str | |
30 are nonzero, | |
31 .I n | |
32 must be at least the allocation size of | |
33 .I str | |
34 minus 1. Proper value for | |
35 .I n | |
36 can be calculated using | |
37 .BR zstr_length (3). | |
38 .SH RETURN VALUE | |
39 .I str | |
40 is returned unless | |
41 .I str | |
42 is | |
43 .BR 0 . | |
44 If | |
45 .I str | |
46 is | |
47 .BR 0 , | |
48 the string allocated by the function is returned. | |
49 .SH SEE ALSO | |
50 .BR zstr_length (3), | |
51 .BR zsets (3), | |
52 .BR zload (3) |