diff options
Diffstat (limited to 'man3')
| l--------- | man3/libsimple_memptolower.3 | 1 | ||||
| l--------- | man3/libsimple_memptoupper.3 | 1 | ||||
| -rw-r--r-- | man3/libsimple_memreplace.3 | 76 | ||||
| -rw-r--r-- | man3/libsimple_memreplaceelem.3 | 82 | ||||
| -rw-r--r-- | man3/libsimple_memtolower.3 | 92 | ||||
| -rw-r--r-- | man3/libsimple_memtoupper.3 | 92 | ||||
| l--------- | man3/libsimple_stpntolower.3 | 1 | ||||
| l--------- | man3/libsimple_stpntoupper.3 | 1 | ||||
| l--------- | man3/libsimple_stptolower.3 | 1 | ||||
| l--------- | man3/libsimple_stptoupper.3 | 1 | ||||
| -rw-r--r-- | man3/libsimple_strmove.3 | 2 | ||||
| -rw-r--r-- | man3/libsimple_strnreplace.3 | 81 | ||||
| -rw-r--r-- | man3/libsimple_strntolower.3 | 97 | ||||
| -rw-r--r-- | man3/libsimple_strntoupper.3 | 97 | ||||
| -rw-r--r-- | man3/libsimple_strreplace.3 | 76 | ||||
| -rw-r--r-- | man3/libsimple_strtolower.3 | 95 | ||||
| -rw-r--r-- | man3/libsimple_strtoupper.3 | 95 |
17 files changed, 890 insertions, 1 deletions
diff --git a/man3/libsimple_memptolower.3 b/man3/libsimple_memptolower.3 new file mode 120000 index 0000000..15069ef --- /dev/null +++ b/man3/libsimple_memptolower.3 @@ -0,0 +1 @@ +libsimple_memtolower.3
\ No newline at end of file diff --git a/man3/libsimple_memptoupper.3 b/man3/libsimple_memptoupper.3 new file mode 120000 index 0000000..61fe5ba --- /dev/null +++ b/man3/libsimple_memptoupper.3 @@ -0,0 +1 @@ +libsimple_memtoupper.3
\ No newline at end of file diff --git a/man3/libsimple_memreplace.3 b/man3/libsimple_memreplace.3 new file mode 100644 index 0000000..25fd6d1 --- /dev/null +++ b/man3/libsimple_memreplace.3 @@ -0,0 +1,76 @@ +.TH LIBSIMPLE_MEMREPLACE 3 2018-11-25 libsimple +.SH NAME +libsimple_memreplace \- replace bytes in an array of bytes +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline void *libsimple_memreplace(void *\fIs\fP, int \fIold\fP, int \fInew\fP, size_t \fIn\fP); + +#ifndef memreplace +# define memreplace libsimple_memreplace +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_memreplace () +function replaces all instances of the byte +.I old +(it is converted to a +.BR char ) +in the byte array +.IR s , +with the size +.IR n , +with the byte +.IR new . +.PP +The comparison is case-sensitive. +.SH RETURN VALUE +The +.BR libsimple_memreplace () +function returns +.IR &s[n] . +.SH ERRORS +The +.BR libsimple_memreplace () +function 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_memreplace () +T} Thread safety MT-Safe +T{ +.BR libsimple_memreplace () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_memreplace () +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_memtolower (3), +.BR libsimple_memtoupper (3), +.BR libsimple_strreplace (3), +.BR libsimple_strnreplace (3), +.BR libsimple_memreplaceelem (3) diff --git a/man3/libsimple_memreplaceelem.3 b/man3/libsimple_memreplaceelem.3 new file mode 100644 index 0000000..02e0f06 --- /dev/null +++ b/man3/libsimple_memreplaceelem.3 @@ -0,0 +1,82 @@ +.TH LIBSIMPLE_MEMREPLACEELEM 3 2018-11-25 libsimple +.SH NAME +libsimple_memreplaceelem \- replace elements in an array +.SH SYNOPSIS +.nf +#include <libsimple.h> + +void *libsimple_memreplaceelem(void *\fIs\fP, int \fIold\fP, int \fInew\fP, size_t \fIn\fP, size_t \fIwidth\fP); + +#ifndef memreplaceelem +# define memreplaceelem libsimple_memreplaceelem +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_memreplaceelem () +function replaces all instances of the element +.IR old , +with size +.IR width , +in the array +.IR s , +with the size of +.I n +elements of size +.IR width , +with the element +.IR new , +also with the size +.IR width . +The replace elements in +.I s +are aligned by +.I width +bytes in +.IR s . +.SH RETURN VALUE +The +.BR libsimple_memreplaceelem () +function returns +.IR &s[n*width] . +.SH ERRORS +The +.BR libsimple_memreplaceelem () +function 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_memreplaceelem () +T} Thread safety MT-Safe +T{ +.BR libsimple_memreplaceelem () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_memreplaceelem () +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_memreplace (3), +.BR libsimple_strreplace (3), +.BR libsimple_strnreplace (3) diff --git a/man3/libsimple_memtolower.3 b/man3/libsimple_memtolower.3 new file mode 100644 index 0000000..be09689 --- /dev/null +++ b/man3/libsimple_memtolower.3 @@ -0,0 +1,92 @@ +.TH LIBSIMPLE_MEMTOLOWER 3 2018-11-25 libsimple +.SH NAME +libsimple_memtolower, libsimple_memptolower \- convert a character array to lower case +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline void *libsimple_memtolower(void *\fIdest\fP, const void *\fIsrc\fP, size_t \fIn\fP); +void *libsimple_memptolower(void *\fIdest\fP, const void *\fIsrc\fP, size_t \fIn\fP); + +#ifndef memtolower +# define memtolower libsimple_memtolower +#endif +#ifndef memptolower +# define memptolower libsimple_memptolower +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_memtolower () +and +.BR libsimple_memptolower () +functions copies the first +.I n +characters from the array +.I src +into the +.I array. +All upper case ASCII characters will be converted +to lower case. The arrays may overlap, and there +is an optimisation for the case where +.IR dest==src . +.SH RETURN VALUE +The +.BR libsimple_memtolower () +function returns the pointer +.IR dest . +.PP +The +.BR libsimple_memptolower () +function returns +.IR &dest[n] . +.SH ERRORS +The +.BR libsimple_memtolower () +and +.BR libsimple_memptolower () +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_memtolower (), +.br +.BR libsimple_memptolower () +T} Thread safety MT-Safe +T{ +.BR libsimple_memtolower (), +.br +.BR libsimple_memptolower () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_memtolower (), +.br +.BR libsimple_memptolower () +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_memtoupper (3), +.BR libsimple_memreplace (3), +.BR libsimple_strtolower (3), +.BR libsimple_strntolower (3) diff --git a/man3/libsimple_memtoupper.3 b/man3/libsimple_memtoupper.3 new file mode 100644 index 0000000..6f45d54 --- /dev/null +++ b/man3/libsimple_memtoupper.3 @@ -0,0 +1,92 @@ +.TH LIBSIMPLE_MEMTOUPPER 3 2018-11-25 libsimple +.SH NAME +libsimple_memtoupper, libsimple_memptoupper \- convert a character array to upper case +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline void *libsimple_memtoupper(void *\fIdest\fP, const void *\fIsrc\fP, size_t \fIn\fP); +void *libsimple_memptoupper(void *\fIdest\fP, const void *\fIsrc\fP, size_t \fIn\fP); + +#ifndef memtoupper +# define memtoupper libsimple_memtoupper +#endif +#ifndef memptoupper +# define memptoupper libsimple_memptoupper +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_memtoupper () +and +.BR libsimple_memptoupper () +functions copies the first +.I n +characters from the array +.I src +into the +.I array. +All lower case ASCII characters will be converted +to upper case. The arrays may overlap, and there +is an optimisation for the case where +.IR dest==src . +.SH RETURN VALUE +The +.BR libsimple_memtoupper () +function returns the pointer +.IR dest . +.PP +The +.BR libsimple_memptoupper () +function returns +.IR &dest[n] . +.SH ERRORS +The +.BR libsimple_memtoupper () +and +.BR libsimple_memptoupper () +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_memtoupper (), +.br +.BR libsimple_memptoupper () +T} Thread safety MT-Safe +T{ +.BR libsimple_memtoupper (), +.br +.BR libsimple_memptoupper () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_memtoupper (), +.br +.BR libsimple_memptoupper () +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_memtolower (3), +.BR libsimple_memreplace (3), +.BR libsimple_strtoupper (3), +.BR libsimple_strntoupper (3) diff --git a/man3/libsimple_stpntolower.3 b/man3/libsimple_stpntolower.3 new file mode 120000 index 0000000..8ed56d9 --- /dev/null +++ b/man3/libsimple_stpntolower.3 @@ -0,0 +1 @@ +libsimple_strntolower.3
\ No newline at end of file diff --git a/man3/libsimple_stpntoupper.3 b/man3/libsimple_stpntoupper.3 new file mode 120000 index 0000000..72dc5e6 --- /dev/null +++ b/man3/libsimple_stpntoupper.3 @@ -0,0 +1 @@ +libsimple_strntoupper.3
\ No newline at end of file diff --git a/man3/libsimple_stptolower.3 b/man3/libsimple_stptolower.3 new file mode 120000 index 0000000..cc6ac1f --- /dev/null +++ b/man3/libsimple_stptolower.3 @@ -0,0 +1 @@ +libsimple_strtolower.3
\ No newline at end of file diff --git a/man3/libsimple_stptoupper.3 b/man3/libsimple_stptoupper.3 new file mode 120000 index 0000000..ec7e542 --- /dev/null +++ b/man3/libsimple_stptoupper.3 @@ -0,0 +1 @@ +libsimple_strtoupper.3
\ No newline at end of file diff --git a/man3/libsimple_strmove.3 b/man3/libsimple_strmove.3 index 39c4572..a145c62 100644 --- a/man3/libsimple_strmove.3 +++ b/man3/libsimple_strmove.3 @@ -5,7 +5,7 @@ libsimple_strmove \- move a string within an array of bytes .nf #include <libsimple.h> -static inline void *libsimple_strmove(void *\fIdest\fP, const void *\fIsrc\fP); +static inline char *libsimple_strmove(char *\fIdest\fP, const char *\fIsrc\fP); #ifndef strmove # define strmove libsimple_strmove diff --git a/man3/libsimple_strnreplace.3 b/man3/libsimple_strnreplace.3 new file mode 100644 index 0000000..ef2a4fe --- /dev/null +++ b/man3/libsimple_strnreplace.3 @@ -0,0 +1,81 @@ +.TH LIBSIMPLE_STRNREPLACE 3 2018-11-25 libsimple +.SH NAME +libsimple_strnreplace \- replace characters in a string +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strnreplace(char *\fIs\fP, int \fIold\fP, int \fInew\fP, size_t \fIn\fP); + +#ifndef strnreplace +# define strnreplace libsimple_strnreplace +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strnreplace () +function replaces all instances of the character +.I old +(it is converted to a +.BR char ) +in the string +.I s +with the character +.IR new , +up to the +.I n th +character (up the last character +.I s +is shorter). +.PP +The comparison is case-sensitive. +.SH RETURN VALUE +The +.BR libsimple_strnreplace () +function returns the end of +.IR s , +that is +.I &s[strnlen(s,n)] +(as evaluated before the function call). +.SH ERRORS +The +.BR libsimple_strnreplace () +function 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_strnreplace () +T} Thread safety MT-Safe +T{ +.BR libsimple_strnreplace () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strnreplace () +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_strntolower (3), +.BR libsimple_strntoupper (3), +.BR libsimple_strreplace (3), +.BR libsimple_memreplace (3) diff --git a/man3/libsimple_strntolower.3 b/man3/libsimple_strntolower.3 new file mode 100644 index 0000000..805adf4 --- /dev/null +++ b/man3/libsimple_strntolower.3 @@ -0,0 +1,97 @@ +.TH LIBSIMPLE_STRNTOLOWER 3 2018-11-25 libsimple +.SH NAME +libsimple_strntolower, libsimple_stpntolower \- convert a string to lower case +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strntolower(char *\fIdest\fP, const char *\fIsrc\fP, size_t \fIn\fP); +char *libsimple_stpntolower(char *\fIdest\fP, const char *\fIsrc\fP, size_t \fIn\fP); + +#ifndef strntolower +# define strntolower libsimple_strntolower +#endif +#ifndef stpntolower +# define stpntolower libsimple_stpntolower +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strntolower () +and +.BR libsimple_stpntolower () +functions copies and covert a string, including the +NUL byte that terminates it, to lower case. +The string +.I src +is copied into +.IR dest , +with all upper case ASCII characters converted to +lower case; however no more than +.I n +bytes will be copied or coverted. The arrays may overlap, +and there is an optimisation for the case where +.IR dest==src . +.SH RETURN VALUE +The +.BR libsimple_strntolower () +function returns the pointer +.IR dest . +.PP +The +.BR libsimple_stpntolower () +function returns the pointer +end of the string copied into +.IR dest , +that is +.IR &dest[strnlen(src,n)] . +.SH ERRORS +The +.BR libsimple_strntolower () +and +.BR libsimple_stpntolower () +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_strntolower (), +.br +.BR libsimple_stpntolower () +T} Thread safety MT-Safe +T{ +.BR libsimple_strntolower (), +.br +.BR libsimple_stpntolower () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strntolower (), +.br +.BR libsimple_stpntolower () +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_strntoupper (3), +.BR libsimple_strnreplace (3), +.BR libsimple_strnntolower (3), +.BR libsimple_memntolower (3) diff --git a/man3/libsimple_strntoupper.3 b/man3/libsimple_strntoupper.3 new file mode 100644 index 0000000..f045291 --- /dev/null +++ b/man3/libsimple_strntoupper.3 @@ -0,0 +1,97 @@ +.TH LIBSIMPLE_STRNTOUPPER 3 2018-11-25 libsimple +.SH NAME +libsimple_strntoupper, libsimple_stpntoupper \- convert a string to upper case +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strntoupper(char *\fIdest\fP, const char *\fIsrc\fP, size_t \fIn\fP); +char *libsimple_stpntoupper(char *\fIdest\fP, const char *\fIsrc\fP, size_t \fIn\fP); + +#ifndef strntoupper +# define strntoupper libsimple_strntoupper +#endif +#ifndef stpntoupper +# define stpntoupper libsimple_stpntoupper +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strntoupper () +and +.BR libsimple_stpntoupper () +functions copies and covert a string, including the +NUL byte that terminates it, to upper case. +The string +.I src +is copied into +.IR dest , +with all lower case ASCII characters converted to +upper case; however no more than +.I n +bytes will be copied or coverted. The arrays may overlap, +and there is an optimisation for the case where +.IR dest==src . +.SH RETURN VALUE +The +.BR libsimple_strntoupper () +function returns the pointer +.IR dest . +.PP +The +.BR libsimple_stpntoupper () +function returns the pointer +end of the string copied into +.IR dest , +that is +.IR &dest[strnlen(src,n)] . +.SH ERRORS +The +.BR libsimple_strntoupper () +and +.BR libsimple_stpntoupper () +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_strntoupper (), +.br +.BR libsimple_stpntoupper () +T} Thread safety MT-Safe +T{ +.BR libsimple_strntoupper (), +.br +.BR libsimple_stpntoupper () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strntoupper (), +.br +.BR libsimple_stpntoupper () +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_strntolower (3), +.BR libsimple_strnreplace (3), +.BR libsimple_strnntoupper (3), +.BR libsimple_memntoupper (3) diff --git a/man3/libsimple_strreplace.3 b/man3/libsimple_strreplace.3 new file mode 100644 index 0000000..96d20e0 --- /dev/null +++ b/man3/libsimple_strreplace.3 @@ -0,0 +1,76 @@ +.TH LIBSIMPLE_STRREPLACE 3 2018-11-25 libsimple +.SH NAME +libsimple_strreplace \- replace characters in a string +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strreplace(char *\fIs\fP, int \fIold\fP, int \fInew\fP); + +#ifndef strreplace +# define strreplace libsimple_strreplace +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strreplace () +function replaces all instances of the character +.I old +(it is converted to a +.BR char ) +in the string +.I s +with the character +.IR new . +.PP +The comparison is case-sensitive. +.SH RETURN VALUE +The +.BR libsimple_strreplace () +function returns the end of +.IR s , +that is +.I &s[strlen(s)] +(as evaluated before the function call). +.SH ERRORS +The +.BR libsimple_strreplace () +function 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_strreplace () +T} Thread safety MT-Safe +T{ +.BR libsimple_strreplace () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strreplace () +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_strtolower (3), +.BR libsimple_strtoupper (3), +.BR libsimple_strnreplace (3), +.BR libsimple_memreplace (3) diff --git a/man3/libsimple_strtolower.3 b/man3/libsimple_strtolower.3 new file mode 100644 index 0000000..385de39 --- /dev/null +++ b/man3/libsimple_strtolower.3 @@ -0,0 +1,95 @@ +.TH LIBSIMPLE_STRTOLOWER 3 2018-11-25 libsimple +.SH NAME +libsimple_strtolower, libsimple_stptolower \- convert a string to lower case +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strtolower(char *\fIdest\fP, const char *\fIsrc\fP); +char *libsimple_stptolower(char *\fIdest\fP, const char *\fIsrc\fP); + +#ifndef strtolower +# define strtolower libsimple_strtolower +#endif +#ifndef stptolower +# define stptolower libsimple_stptolower +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strtolower () +and +.BR libsimple_stptolower () +functions copies and covert a string, including the +NUL byte that terminates it, to lower case. +The string +.I src +is copied into +.IR dest , +with all upper case ASCII characters converted to +lower case. The arrays may overlap, and there is +an optimisation for the case where +.IR dest==src . +.SH RETURN VALUE +The +.BR libsimple_strtolower () +function returns the pointer +.IR dest . +.PP +The +.BR libsimple_stptolower () +function returns the pointer +end of the string copied into +.IR dest , +that is +.IR &dest[strlen(src)] . +.SH ERRORS +The +.BR libsimple_strtolower () +and +.BR libsimple_stptolower () +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_strtolower (), +.br +.BR libsimple_stptolower () +T} Thread safety MT-Safe +T{ +.BR libsimple_strtolower (), +.br +.BR libsimple_stptolower () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strtolower (), +.br +.BR libsimple_stptolower () +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_strtoupper (3), +.BR libsimple_strreplace (3), +.BR libsimple_strntolower (3), +.BR libsimple_memtolower (3) diff --git a/man3/libsimple_strtoupper.3 b/man3/libsimple_strtoupper.3 new file mode 100644 index 0000000..cc1de4f --- /dev/null +++ b/man3/libsimple_strtoupper.3 @@ -0,0 +1,95 @@ +.TH LIBSIMPLE_STRTOUPPER 3 2018-11-25 libsimple +.SH NAME +libsimple_strtoupper, libsimple_stptoupper \- convert a string to upper case +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strtoupper(char *\fIdest\fP, const char *\fIsrc\fP); +char *libsimple_stptoupper(char *\fIdest\fP, const char *\fIsrc\fP); + +#ifndef strtoupper +# define strtoupper libsimple_strtoupper +#endif +#ifndef stptoupper +# define stptoupper libsimple_stptoupper +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strtoupper () +and +.BR libsimple_stptoupper () +functions copies and covert a string, including the +NUL byte that terminates it, to upper case. +The string +.I src +is copied into +.IR dest , +with all lower case ASCII characters converted to +upper case. The arrays may overlap, and there is +an optimisation for the case where +.IR dest==src . +.SH RETURN VALUE +The +.BR libsimple_strtoupper () +function returns the pointer +.IR dest . +.PP +The +.BR libsimple_stptoupper () +function returns the pointer +end of the string copied into +.IR dest , +that is +.IR &dest[strlen(src)] . +.SH ERRORS +The +.BR libsimple_strtoupper () +and +.BR libsimple_stptoupper () +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_strtoupper (), +.br +.BR libsimple_stptoupper () +T} Thread safety MT-Safe +T{ +.BR libsimple_strtoupper (), +.br +.BR libsimple_stptoupper () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strtoupper (), +.br +.BR libsimple_stptoupper () +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_strtolower (3), +.BR libsimple_strreplace (3), +.BR libsimple_strntoupper (3), +.BR libsimple_memtoupper (3) |