xref: /freebsd/share/man/man9/memcchr.9 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1*194cef31SEd Schouten.\" Copyright (c) 2012 Ed Schouten <ed@FreeBSD.org>
2*194cef31SEd Schouten.\" All rights reserved.
3*194cef31SEd Schouten.\"
4*194cef31SEd Schouten.\" Redistribution and use in source and binary forms, with or without
5*194cef31SEd Schouten.\" modification, are permitted provided that the following conditions
6*194cef31SEd Schouten.\" are met:
7*194cef31SEd Schouten.\" 1. Redistributions of source code must retain the above copyright
8*194cef31SEd Schouten.\"    notice, this list of conditions and the following disclaimer.
9*194cef31SEd Schouten.\" 2. Redistributions in binary form must reproduce the above copyright
10*194cef31SEd Schouten.\"    notice, this list of conditions and the following disclaimer in the
11*194cef31SEd Schouten.\"    documentation and/or other materials provided with the distribution.
12*194cef31SEd Schouten.\"
13*194cef31SEd Schouten.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14*194cef31SEd Schouten.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*194cef31SEd Schouten.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*194cef31SEd Schouten.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17*194cef31SEd Schouten.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*194cef31SEd Schouten.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*194cef31SEd Schouten.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*194cef31SEd Schouten.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*194cef31SEd Schouten.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*194cef31SEd Schouten.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*194cef31SEd Schouten.\" SUCH DAMAGE.
24*194cef31SEd Schouten.\"
25*194cef31SEd Schouten.Dd January 1, 2012
26*194cef31SEd Schouten.Dt MEMCCHR 9
27*194cef31SEd Schouten.Os
28*194cef31SEd Schouten.Sh NAME
29*194cef31SEd Schouten.Nm memcchr
30*194cef31SEd Schouten.Nd locate the complement of a byte in byte string
31*194cef31SEd Schouten.Sh SYNOPSIS
32*194cef31SEd Schouten.In sys/libkern.h
33*194cef31SEd Schouten.Ft void *
34*194cef31SEd Schouten.Fn memcchr "const void *b" "int c" "size_t len"
35*194cef31SEd Schouten.Sh DESCRIPTION
36*194cef31SEd SchoutenThe
37*194cef31SEd Schouten.Fn memcchr
38*194cef31SEd Schoutenfunction locates the first occurrence of a byte unequal to
39*194cef31SEd Schouten.Fa c
40*194cef31SEd Schouten(converted to an
41*194cef31SEd Schouten.Vt "unsigned char" )
42*194cef31SEd Schoutenin string
43*194cef31SEd Schouten.Fa b .
44*194cef31SEd Schouten.Sh RETURN VALUES
45*194cef31SEd SchoutenThe
46*194cef31SEd Schouten.Fn memcchr
47*194cef31SEd Schoutenfunction returns a pointer to the byte located, or NULL if no such byte
48*194cef31SEd Schoutenexists within
49*194cef31SEd Schouten.Fa len
50*194cef31SEd Schoutenbytes.
51*194cef31SEd Schouten.Sh SEE ALSO
52*194cef31SEd Schouten.Xr memchr 3
53*194cef31SEd Schouten.Sh HISTORY
54*194cef31SEd SchoutenThe
55*194cef31SEd Schouten.Fn memcchr
56*194cef31SEd Schoutenfunction first appeared in
57*194cef31SEd Schouten.Fx 10.0 .
58