From 25d1d835d2fdd52144a246a8296460e48d3f3950 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 5 Nov 2018 18:29:59 +0100 Subject: Add ischrcaseset and man pages for ischrset, ischrcaseset, and [v]{we,en,e}printf MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man/inchrcaseset.3libsimple | 1 + man/libsimple_inchrcaseset.3 | 1 + man/libsimple_inchrset.3 | 96 ++++++++++++++++++++++ man/libsimple_strcasechr.3 | 1 + man/libsimple_strcasechrnul.3 | 3 +- man/libsimple_strchrnul.3 | 1 + man/libsimple_vasprintf.3 | 2 +- man/libsimple_vputenvf.3 | 2 +- man/libsimple_vweprintf.3 | 179 ++++++++++++++++++++++++++++++++++++++++++ 9 files changed, 283 insertions(+), 3 deletions(-) create mode 120000 man/inchrcaseset.3libsimple create mode 120000 man/libsimple_inchrcaseset.3 create mode 100644 man/libsimple_inchrset.3 create mode 100644 man/libsimple_vweprintf.3 (limited to 'man') diff --git a/man/inchrcaseset.3libsimple b/man/inchrcaseset.3libsimple new file mode 120000 index 0000000..b1f18ca --- /dev/null +++ b/man/inchrcaseset.3libsimple @@ -0,0 +1 @@ +libsimple_inchrcaseset.3 \ No newline at end of file diff --git a/man/libsimple_inchrcaseset.3 b/man/libsimple_inchrcaseset.3 new file mode 120000 index 0000000..50838ca --- /dev/null +++ b/man/libsimple_inchrcaseset.3 @@ -0,0 +1 @@ +libsimple_inchrset.3 \ No newline at end of file diff --git a/man/libsimple_inchrset.3 b/man/libsimple_inchrset.3 new file mode 100644 index 0000000..09b1ca1 --- /dev/null +++ b/man/libsimple_inchrset.3 @@ -0,0 +1,96 @@ +.TH LIBSIMPLE_STRCHRNUL 3 2018-11-05 libsimple +.SH NAME +libsimple_inchrset, libsimple_inchrcaseset \- the whether a character belongs to a set +.SH SYNOPSIS +.nf +#include + +static inline int libsimple_inchrset(int \fIc\fP, const char *\fIs\fP); +static inline int libsimple_inchrcaseset(int \fIc\fP, const char *\fIs\fP); + +#ifndef inchrset +# define inchrset libsimple_inchrset +#endif +#ifndef inchrcaseset +# define inchrcaseset libsimple_inchrcaseset +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_inchrset () +and +.BR libsimple_inchrcaseset () +functions scans the string +.I s +for an occurence of the character +.I c +(it is converted to a +.BR char ), +and returns a value indicating whether it exists in the string, +the scan will always fail if +.I c +is the NUL byte. +.PP +The comparison is case-sensitive for the +.BR libsimple_inchrset () +function, and case-insensitive for the +.BR libsimple_inchrcaseset () +function. +.SH RETURN VALUE +The +.BR libsimple_inchrset () +and +.BR libsimple_inchrcaseset () +functions returns 1 if +.I c +is not the NUL byte but can be found in +.IR s ; +otherwise 0 is returned. +.SH ERRORS +The +.BR libsimple_inchrset () +and +.BR libsimple_inchrcaseset () +functions cannot fail. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR libsimple_inchrset (), +.br +.BR libsimple_inchrcaseset () +T} Thread safety MT-Safe +T{ +.BR libsimple_inchrset (), +.br +.BR libsimple_strchrnul () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_inchrset (), +.br +.BR libsimple_strchrnul () +T} Async-cancel safety AC-Safe +.TE +.SH EXAMPLES +None. +.SH APPLICATION USAGE +None. +.SH RATIONALE +None. +.SH FUTURE DIRECTIONS +None. +.SH NOTES +None. +.SH BUGS +None. +.SH SEE ALSO +.BR libsimple_strcasechr (3), +.BR strchr (3) diff --git a/man/libsimple_strcasechr.3 b/man/libsimple_strcasechr.3 index 9e60426..8d644a1 100644 --- a/man/libsimple_strcasechr.3 +++ b/man/libsimple_strcasechr.3 @@ -78,4 +78,5 @@ None. .BR libsimple_strrcasechr (3), .BR libsimple_strncasechr (3), .BR libsimple_memcasechr (3), +.BR libsimple_inchrcaseset (3), .BR strchr (3) diff --git a/man/libsimple_strcasechrnul.3 b/man/libsimple_strcasechrnul.3 index b532249..d2098bb 100644 --- a/man/libsimple_strcasechrnul.3 +++ b/man/libsimple_strcasechrnul.3 @@ -74,4 +74,5 @@ None. .SH SEE ALSO .BR libsimple_strcasechr (3), .BR libsimple_strchrnul (3), -.BR libsimple_strncasechrnul (3) +.BR libsimple_strncasechrnul (3), +.BR libsimple_inchrcaseset (3) diff --git a/man/libsimple_strchrnul.3 b/man/libsimple_strchrnul.3 index 73c5f7d..2196933 100644 --- a/man/libsimple_strchrnul.3 +++ b/man/libsimple_strchrnul.3 @@ -75,4 +75,5 @@ None. .BR libsimple_strcasechrnul (3), .BR libsimple_strend (3), .BR libsimple_strnchrnul (3), +.BR libsimple_inchrset (3), .BR strchr (3) diff --git a/man/libsimple_vasprintf.3 b/man/libsimple_vasprintf.3 index 4ad0b4c..e91c404 100644 --- a/man/libsimple_vasprintf.3 +++ b/man/libsimple_vasprintf.3 @@ -56,7 +56,7 @@ The .BR libsimple_asprintf () function is a version of the .BR libsimple_vasprintf () -that uses variadic arguments instead of +function that uses variadic arguments instead of .BR va_list . .PP The diff --git a/man/libsimple_vputenvf.3 b/man/libsimple_vputenvf.3 index cc7f75d..33c5559 100644 --- a/man/libsimple_vputenvf.3 +++ b/man/libsimple_vputenvf.3 @@ -56,7 +56,7 @@ The .BR libsimple_putenvf () function is a version of the .BR libsimple_vputenvf () -that uses variadic arguments instead of +function that uses variadic arguments instead of .BR va_list . .PP The diff --git a/man/libsimple_vweprintf.3 b/man/libsimple_vweprintf.3 new file mode 100644 index 0000000..ef2bedd --- /dev/null +++ b/man/libsimple_vweprintf.3 @@ -0,0 +1,179 @@ +.TH LIBSIMPLE_VWEPRINTF 3 2018-11-05 libsimple +.SH NAME +libsimple_vweprintf \- print an error message +.SH SYNOPSIS +.nf +#include + +void libsimple_vweprintf(const char *\fIfmt\fP, va_list \fIap\fP); +static inline void libsimple_weprintf(const char *\fIfmt\fP, ...); +static inline void libsimple_venprintf(int \fIstatus\fP, const char *\fIfmt\fP, va_list \fIap\fP); +static inline void libsimple_enprintf(int \fIstatus\fP, const char *\fIfmt\fP, ...); +static inline void libsimple_veprintf(const char *\fIfmt\fP, va_list \fIap\fP); +static inline void libsimple_eprintf(const char *\fIfmt\fP, ...); + +#ifndef vweprintf +# define vweprintf libsimple_vweprintf +#endif +#ifndef weprintf +# define weprintf libsimple_weprintf +#endif +#ifndef venprintf +# define venprintf libsimple_venprintf +#endif +#ifndef enprintf +# define enprintf libsimple_enprintf +#endif +#ifndef veprintf +# define veprintf libsimple_veprintf +#endif +#ifndef eprintf +# define eprintf libsimple_eprintf +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_vweprintf () +function is a version of the +.BR printf (3) +function. It prints the string to the standard error +(rather than the standard output), and attempts to +avoid output mangling in case multiple processes are +writting. Additionally, the output is suffixed with +.nf + + \fB\(dq %s\en\(dq, \fP<\fIerror message\fP> + +.fi +if +.I fmt +ends with a colon +.RB ( : ), +otherwise it is suffixed with a if +.I fmt +does not end with a ; otherwise, if +.I fmt +is the empty string, the output is suffixed with +.nf + + \fB\(dq%s\en\(dq, \fP<\fIerror message\fP> + +.fi +Furthermore, if +.I argv0 +.RB ( "char *" ) +is non-null and +.I fmt +does not start with +.RB \(dq "usage :" \(dq, +the output is preffixed with +.nf + + \fB\(dq%s: \(dq, \fPIargv0\fP +.fi +.PP +The +.BR libsimple_weprintf () +function is a version of the +.BR libsimple_vweprintf () +function that uses variadic arguments instead of +.BR va_list . +.PP +The +.BR libsimple_venprintf () +and +.BR libsimple_enprintf () +functions are versions of the +.BR libsimple_vweprintf () +and +.BR libsimple_weprintf () +functions that terminate the process by calling +.BR exit (3), +the exit value of the process will be +.IR status . +.PP +The +.BR libsimple_veprintf () +and +.BR libsimple_eprintf () +functions are versions of the +.BR libsimple_vweprintf () +and +.BR libsimple_weprintf () +functions that terminate the process by calling +.BR exit (3), +the exit value of the process will be +.IR libsimple_default_failure_exit (3), +which is 1 by default. +.SH RETURN VALUE +None. +.SH ERRORS +None. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR libsimple_vweprintf (), +.br +.BR libsimple_weprintf (), +.br +.BR libsimple_venprintf (), +.br +.BR libsimple_enprintf (), +.br +.BR libsimple_veprintf (), +.br +.BR libsimple_eprintf () +T} Thread safety MT-Unsafe race:strerror +T{ +.BR libsimple_vweprintf (), +.br +.BR libsimple_weprintf (), +.br +.BR libsimple_venprintf (), +.br +.BR libsimple_enprintf (), +.br +.BR libsimple_veprintf (), +.br +.BR libsimple_eprintf () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_vweprintf (), +.br +.BR libsimple_weprintf (), +.br +.BR libsimple_venprintf (), +.br +.BR libsimple_enprintf (), +.br +.BR libsimple_veprintf (), +.br +.BR libsimple_eprintf () +T} Async-cancel safety AC-Safe +.TE +.SH EXAMPLES +None. +.SH APPLICATION USAGE +None. +.SH RATIONALE +None. +.SH FUTURE DIRECTIONS +None. +.SH NOTES +None. +.SH BUGS +None. +.SH SEE ALSO +.BR libsimple_vweprintf (3), +.BR perror (3), +.BR fprintf (3), +.BR exit (3) -- cgit v1.2.3-70-g09d2