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)