1 .\"(c) Copyright 1992, 1993 by Panagiotis Tsirigotis
2 .\"All rights reserved. The file named COPYRIGHT specifies the terms
3 .\"and conditions for redistribution.
5 .\" $Id: strprint.3,v 1.1.1.1 2003/02/19 17:29:27 bbraun Exp $
6 .TH STRPRINT 3X "30 September 1992"
8 str_sprint, tr_sprintv, str_nprint, str_nprintv, str_print, str_printv, strx_sprint, strx_sprintv, strx_nprint, strx_nprintv, strx_print, strx_printv -- formatted conversion to string
16 char *str_sprint( buf, format, ... )
21 char *str_sprintv( buf, format, ap )
27 int str_nprint( buf, format, ... )
32 int str_nprintv( buf, format, ap )
38 void str_print( countp, buf, format, ... )
44 void str_printv( countp, buf, format, ap )
51 char *strx_sprint( buf, len, format, ... )
57 char *strx_sprintv( buf, len, format, ap )
64 int strx_nprint( buf, len, format, ... )
70 int strx_nprintv( buf, len, format, ap )
77 void strx_print( countp, buf, len, format, ... )
84 void strx_printv( countp, buf, len, format, ap )
92 All functions are similar in functionality to \fIsprintf()\fR.
93 Their only difference is in their return values. For information about their
94 conversion capabilities, check \fISprint(3)\fR.
96 The difference between the \fIstr_*\fR and the \fIstrx_*\fR functions
97 is that the latter take an extra argument, the size of the buffer, so
98 that they will never write beyond the end of the buffer. Writing
99 beyond the end of the buffer is possible with the \fIstr_*\fR functions.
100 Previously, invoking any of the \fIstrx_*\fR functions with the
103 used to be the same as calling the equivalent \fIstr_*\fR function.
104 This dangerous behavior has since been changed and now the \fIstrx_*\fR
105 functions don't touch the buffer when
109 All functions will append a
113 (the \fIstrx_*\fR functions will not do this if it would cause
123 the number of characters placed in
127 (this happens only if
133 The functions that have a name ending in 'v' are similar to those without
134 the 'v' at the end of their name
135 except that instead of accepting a variable number of arguments, they
136 expect a \fIstdarg(3)\fR argument list.
152 return the number of characters placed in