1 files changed, 28 insertions, 0 deletions
diff --git a/man/zstr_length_positive.3 b/man/zstr_length_positive.3
new file mode 100644
index 0000000..3696378
--- /dev/null
+++ b/man/zstr_length_positive.3
@@ -0,0 +1,28 @@
+.TH ZSTR_LENGTH_POSITIVE 3 libzahl
+.SH NAME
+zstr_length_positive - Predict the length of a string
+.SH SYNOPSIS
+.nf
+#include <zahl.h>
+
+size_t zstr_length_positive(z_t \fIa\fP, unsigned long long int\fIradix\fP);
+.fi
+.SH DESCRIPTION
+.B zstr_length_positive
+calculates the number of digits required to
+to represent
+.I a
+in the selected
+.IR radix .
+.P
+.I a
+must be a positive integer. If it is zero or negative,
+undefined behaviour is invoked.
+.SH RETURN VALUE
+The number of digits requires to represent
+.I a
+i the selected
+.I radix
+is returned.
+.SH SEE ALSO
+.BR zstr (3)