diff options
Diffstat (limited to 'man3/libsimple_memcasescan.3')
-rw-r--r-- | man3/libsimple_memcasescan.3 | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/man3/libsimple_memcasescan.3 b/man3/libsimple_memcasescan.3 new file mode 100644 index 0000000..9c11c2e --- /dev/null +++ b/man3/libsimple_memcasescan.3 @@ -0,0 +1,86 @@ +.TH LIBSIMPLE_MEMCASESCAN 3 2018-11-17 libsimple +.SH NAME +libsimple_memcasescan \- find byte in memory +.SH SYNOPSIS +.nf +#include <libsimple.h> + +void *libsimple_memcasescan(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP); + +#ifndef memcasescan +# define memcasescan libsimple_memcasescan +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_memcasescan () +function scans the memory segment +.IR s , +with the size +.IR n , +for the first occurence of the byte +.I c +(it is converted to a +.BR char ). +If no such character exist in the memory +segment, the memory segment's end is returned. +.PP +The comparison is case-insensitive. +.SH RETURN VALUE +The +.BR libsimple_memcasescan () +function returns the pointer +.I s +with a minimal offset such that +.IR tolower(*r)==tolower(c) , +where +.I r +is the returned pointer. +If no such offset exists, +.I &s[n] +is returned. +.SH ERRORS +The +.BR libsimple_memcasescan () +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_memcasescan () +T} Thread safety MT-Safe +T{ +.BR libsimple_memcasescan () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_memcasescan () +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_memscan (3), +.BR libsimple_memcasechr (3), +.BR libsimple_memrcasechr (3), +.BR libsimple_rawmemcasechr (3), +.BR libsimple_memcasemem (3), +.BR libsimple_strncasechrnul (3), +.BR libsimple_strcasechrnul (3) |