aboutsummaryrefslogtreecommitdiffstats
path: root/man/INTSTRLEN.3libsimple
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2018-11-05 23:03:15 +0100
committerMattias Andrée <maandree@kth.se>2018-11-05 23:03:15 +0100
commit2cc97e5ce4a53ba52e6c283bdabe7b5028d237ed (patch)
tree97e77ff81fc6cea7ac3ac54657dbdf3b882b08df /man/INTSTRLEN.3libsimple
parentAdd man page for libsimple_close (diff)
downloadlibsimple-2cc97e5ce4a53ba52e6c283bdabe7b5028d237ed.tar.gz
libsimple-2cc97e5ce4a53ba52e6c283bdabe7b5028d237ed.tar.bz2
libsimple-2cc97e5ce4a53ba52e6c283bdabe7b5028d237ed.tar.xz
Add more man pages
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'man/INTSTRLEN.3libsimple')
-rw-r--r--man/INTSTRLEN.3libsimple46
1 files changed, 46 insertions, 0 deletions
diff --git a/man/INTSTRLEN.3libsimple b/man/INTSTRLEN.3libsimple
new file mode 100644
index 0000000..63c1485
--- /dev/null
+++ b/man/INTSTRLEN.3libsimple
@@ -0,0 +1,46 @@
+.TH INTSTRLEN 3 2018-11-05 libsimple
+.SH NAME
+INTSTRLEN \- get the maximum length of an integer string
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+#ifndef INTSTRLEN
+# define INTSTRLEN(type) /* implementation omitted */
+#endif
+.fi
+.SH DESCRIPTION
+The
+.BR INTSTRLEN ()
+macro assumes
+.I type
+is an integer type, and expends to a value representing
+a number of bytes sufficiently large to store any value
+of the specified integer type as a string without leading
+zeroes or plus sign, and
+.IR "without a terminating NUL byte" ,
+as a constant expression in the type
+.BR size_t ;
+however it is not suitable for
+.BR #if .
+.PP
+The resulting value can depend in either the type is
+signed or unsigned, and can be slightly larger than
+necessary, it can however not be smaller. (For integers
+up to 64 bits, the result is only off by one for signed
+64-bit integer types.)
+.SH EXAMPLES
+None.
+.SH APPLICATION USAGE
+None.
+.SH RATIONALE
+None.
+.SH FUTURE DIRECTIONS
+None.
+.SH NOTES
+None.
+.SH BUGS
+None.
+.SH SEE ALSO
+.BR TYPE_MIN (3libsimple)
+.BR TYPE_MAX (3libsimple)