diff options
-rw-r--r-- | libsimple/strn.h | 2 | ||||
-rw-r--r-- | man/libsimple_strend.3 | 3 | ||||
-rw-r--r-- | man/libsimple_strnend.3 | 78 |
3 files changed, 81 insertions, 2 deletions
diff --git a/libsimple/strn.h b/libsimple/strn.h index 0959100..03c849a 100644 --- a/libsimple/strn.h +++ b/libsimple/strn.h @@ -112,7 +112,7 @@ char *libsimple_strrncasechr(const char *, int, size_t); /* TODO doc */ * if `s`, `&s[n]` is returned */ _LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __nonnull__, __returns_nonnull__, __warn_unused_result__))) -char *libsimple_strnend(const char *, size_t); /* TODO doc */ +char *libsimple_strnend(const char *, size_t); #ifndef strnend # define strnend libsimple_strnend #endif diff --git a/man/libsimple_strend.3 b/man/libsimple_strend.3 index e1652b6..adfdf6f 100644 --- a/man/libsimple_strend.3 +++ b/man/libsimple_strend.3 @@ -1,4 +1,4 @@ -.TH LIBSIMPLE_STREND 3 2018-10-21 libsimple +.TH LIBSIMPLE_STREND 3 2018-10-23 libsimple .SH NAME libsimple_strend \- find a character in a string .SH SYNOPSIS @@ -66,4 +66,5 @@ None. None. .SH SEE ALSO .BR libsimple_strchrnul (3), +.BR libsimple_strnend (3), .BR strchr (3) diff --git a/man/libsimple_strnend.3 b/man/libsimple_strnend.3 new file mode 100644 index 0000000..26ed564 --- /dev/null +++ b/man/libsimple_strnend.3 @@ -0,0 +1,78 @@ +.TH LIBSIMPLE_STRNEND 3 2018-10-23 libsimple +.SH NAME +libsimple_strnend \- find a character in a string +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline char *libsimple_strnend(const char *\fIs\fP, size_t \fIn\fP); + +#ifndef strnend +# define strnend libsimple_strnend +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strnend () +function scans the string +.IR s , +truncated to +.I n +bytes unless it is shorter, +for its end. +.SH RETURN VALUE +The +.BR libsimple_strnend () +function returns the pointer +.I s +with an offset such that +.IR !*r , +where +.I r +is the returned pointer. However, +if no such offset less than +.I n +exists, +.I &s[n] +is returned. +.SH ERRORS +The +.BR libsimple_strnend () +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_strnend () +T} Thread safety MT-Safe +T{ +.BR libsimple_strnend () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strnend () +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_strnchrnul (3), +.BR libsimple_strnchr (3), +.BR libsimple_strend (3) |