aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2018-11-05 18:29:59 +0100
committerMattias Andrée <maandree@kth.se>2018-11-05 18:29:59 +0100
commit25d1d835d2fdd52144a246a8296460e48d3f3950 (patch)
tree45b7d412830fb6a6b1b7ab6fdc750fee2037e27c /man
parentAdd man page for the [v]asprintf[a] functions (diff)
downloadlibsimple-25d1d835d2fdd52144a246a8296460e48d3f3950.tar.gz
libsimple-25d1d835d2fdd52144a246a8296460e48d3f3950.tar.bz2
libsimple-25d1d835d2fdd52144a246a8296460e48d3f3950.tar.xz
Add ischrcaseset and man pages for ischrset, ischrcaseset, and [v]{we,en,e}printf
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
l---------man/inchrcaseset.3libsimple1
l---------man/libsimple_inchrcaseset.31
-rw-r--r--man/libsimple_inchrset.396
-rw-r--r--man/libsimple_strcasechr.31
-rw-r--r--man/libsimple_strcasechrnul.33
-rw-r--r--man/libsimple_strchrnul.31
-rw-r--r--man/libsimple_vasprintf.32
-rw-r--r--man/libsimple_vputenvf.32
-rw-r--r--man/libsimple_vweprintf.3179
9 files changed, 283 insertions, 3 deletions
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 <libsimple.h>
+
+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 <libsimple.h>
+
+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 <newline> if
+.I fmt
+does not end with a <newline>; 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)