summaryrefslogtreecommitdiffstats
path: root/man3/bcmp.3
blob: 3ede10b8bf96d681b3b441fbf2dfaaef43325064 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 21:36:50 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Tue Oct 22 23:47:36 1996 by Eric S. Raymond <esr@thyrsus.com>
.TH BCMP 3  2021-03-22 "Linux man-pages (unreleased)"
.SH NAME
bcmp \- compare byte sequences
.SH LIBRARY
Standard C library
.RI ( libc ", " \-lc )
.SH SYNOPSIS
.nf
.B #include <strings.h>
.PP
.BI "int bcmp(const void *" s1 ", const void *" s2 ", size_t " n );
.fi
.SH DESCRIPTION
The
.BR bcmp ()
function compares the two byte sequences
.I s1
and
.I s2
of length
.I n
each.
If they are equal, and in particular if
.I n
is zero,
.BR bcmp ()
returns 0.
Otherwise, it returns a nonzero result.
.SH RETURN VALUE
The
.BR bcmp ()
function returns 0 if the byte sequences are equal,
otherwise a nonzero result is returned.
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribute	Value
T{
.BR bcmp ()
T}	Thread safety	MT-Safe
.TE
.hy
.ad
.sp 1
.SH STANDARDS
4.3BSD.
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
.BR memcmp (3)
in new programs.
POSIX.1-2008 removes the specification of
.BR bcmp ().
.SH SEE ALSO
.BR bstring (3),
.BR memcmp (3),
.BR strcasecmp (3),
.BR strcmp (3),
.BR strcoll (3),
.BR strncasecmp (3),
.BR strncmp (3)