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