diff options
Diffstat (limited to 'man3/libsimple_strncasecmpnul.3')
-rw-r--r-- | man3/libsimple_strncasecmpnul.3 | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/man3/libsimple_strncasecmpnul.3 b/man3/libsimple_strncasecmpnul.3 new file mode 100644 index 0000000..959ea78 --- /dev/null +++ b/man3/libsimple_strncasecmpnul.3 @@ -0,0 +1,91 @@ +.TH LIBSIMPLE_STRNCASECMPNUL 3 2018-10-23 libsimple +.SH NAME +libsimple_strncasecmpnul \- compare two strings +.SH SYNOPSIS +.nf +#include <libsimple.h> + +static inline int libsimple_strncasecmpnul(const char *\fIa\fP, const char *\fIb\fP, size_t \fIn\fP); + +#ifndef strncasecmpnul +# define strncasecmpnul libsimple_strncasecmpnul +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_strncasecmpnul () +function compares the strings +.IR a , +truncated to +.I n +bytes unless it is shorter, +and +.IR b , +truncated to +.I n +bytes unless it is shorter, +both of which may be +.BR NULL , +which is treated as less than the empty string. +.PP +If one of the strings begins with the other string +but is longer, the longer string is treated as +greater than the shorter string. +.PP +The comparison is case-insensitive and made as +if the strings were converted to lowercase and as +.BR "unsigned char *" s. +.SH RETURN VALUE +The +.BR libsimple_strncasecmpnul () +function returns a negative value if +.I a +is less than +.IR b , +a positive value if +.I a +is greater than +.IR b , +and 0 otherwise. +.SH ERRORS +The +.BR libsimple_strncasecmpnul () +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_strncasecmpnul () +T} Thread safety MT-Safe +T{ +.BR libsimple_strncasecmpnul () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_strncasecmpnul () +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_strncmpnul (3), +.BR libsimple_strncaseeqnul (3), +.BR libsimple_strcasecmpnul (3), +.BR strncasecmp (3) |