xref: /minix3/lib/libc/string/strcasecmp.3 (revision 2fe8fb192fe7e8720e3e7a77f928da545e872a6a)
1*2fe8fb19SBen Gras.\" Copyright (c) 1990, 1991, 1993
2*2fe8fb19SBen Gras.\"	The Regents of the University of California.  All rights reserved.
3*2fe8fb19SBen Gras.\"
4*2fe8fb19SBen Gras.\" This code is derived from software contributed to Berkeley by
5*2fe8fb19SBen Gras.\" Chris Torek.
6*2fe8fb19SBen Gras.\" Redistribution and use in source and binary forms, with or without
7*2fe8fb19SBen Gras.\" modification, are permitted provided that the following conditions
8*2fe8fb19SBen Gras.\" are met:
9*2fe8fb19SBen Gras.\" 1. Redistributions of source code must retain the above copyright
10*2fe8fb19SBen Gras.\"    notice, this list of conditions and the following disclaimer.
11*2fe8fb19SBen Gras.\" 2. Redistributions in binary form must reproduce the above copyright
12*2fe8fb19SBen Gras.\"    notice, this list of conditions and the following disclaimer in the
13*2fe8fb19SBen Gras.\"    documentation and/or other materials provided with the distribution.
14*2fe8fb19SBen Gras.\" 3. Neither the name of the University nor the names of its contributors
15*2fe8fb19SBen Gras.\"    may be used to endorse or promote products derived from this software
16*2fe8fb19SBen Gras.\"    without specific prior written permission.
17*2fe8fb19SBen Gras.\"
18*2fe8fb19SBen Gras.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19*2fe8fb19SBen Gras.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20*2fe8fb19SBen Gras.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21*2fe8fb19SBen Gras.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22*2fe8fb19SBen Gras.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23*2fe8fb19SBen Gras.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24*2fe8fb19SBen Gras.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25*2fe8fb19SBen Gras.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26*2fe8fb19SBen Gras.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27*2fe8fb19SBen Gras.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28*2fe8fb19SBen Gras.\" SUCH DAMAGE.
29*2fe8fb19SBen Gras.\"
30*2fe8fb19SBen Gras.\"     from: @(#)strcasecmp.3	8.1 (Berkeley) 6/9/93
31*2fe8fb19SBen Gras.\"	$NetBSD: strcasecmp.3,v 1.17 2006/10/16 08:48:45 wiz Exp $
32*2fe8fb19SBen Gras.\"
33*2fe8fb19SBen Gras.Dd June 9, 1993
34*2fe8fb19SBen Gras.Dt STRCASECMP 3
35*2fe8fb19SBen Gras.Os
36*2fe8fb19SBen Gras.Sh NAME
37*2fe8fb19SBen Gras.Nm strcasecmp ,
38*2fe8fb19SBen Gras.Nm strncasecmp
39*2fe8fb19SBen Gras.Nd compare strings, ignoring case
40*2fe8fb19SBen Gras.Sh LIBRARY
41*2fe8fb19SBen Gras.Lb libc
42*2fe8fb19SBen Gras.Sh SYNOPSIS
43*2fe8fb19SBen Gras.In strings.h
44*2fe8fb19SBen Gras.Ft int
45*2fe8fb19SBen Gras.Fn strcasecmp "const char *s1" "const char *s2"
46*2fe8fb19SBen Gras.Ft int
47*2fe8fb19SBen Gras.Fn strncasecmp "const char *s1" "const char *s2" "size_t len"
48*2fe8fb19SBen Gras.Sh DESCRIPTION
49*2fe8fb19SBen GrasThe
50*2fe8fb19SBen Gras.Fn strcasecmp
51*2fe8fb19SBen Grasand
52*2fe8fb19SBen Gras.Fn strncasecmp
53*2fe8fb19SBen Grasfunctions
54*2fe8fb19SBen Grascompare the nul-terminated strings
55*2fe8fb19SBen Gras.Fa s1
56*2fe8fb19SBen Grasand
57*2fe8fb19SBen Gras.Fa s2
58*2fe8fb19SBen Grasand return an integer greater than, equal to, or less than 0,
59*2fe8fb19SBen Grasaccording to whether
60*2fe8fb19SBen Gras.Fa s1
61*2fe8fb19SBen Grasis lexicographically greater than, equal to, or less than
62*2fe8fb19SBen Gras.Fa s2
63*2fe8fb19SBen Grasafter translation of each corresponding character to lower-case.
64*2fe8fb19SBen GrasThe strings themselves are not modified.
65*2fe8fb19SBen GrasThe comparison is done using unsigned characters, so that
66*2fe8fb19SBen Gras.Sq Li \e200
67*2fe8fb19SBen Grasis greater than
68*2fe8fb19SBen Gras.Ql \e0 .
69*2fe8fb19SBen Gras.Pp
70*2fe8fb19SBen GrasThe
71*2fe8fb19SBen Gras.Fn strncasecmp
72*2fe8fb19SBen Grascompares at most
73*2fe8fb19SBen Gras.Fa len
74*2fe8fb19SBen Grascharacters.
75*2fe8fb19SBen Gras.Sh SEE ALSO
76*2fe8fb19SBen Gras.Xr bcmp 3 ,
77*2fe8fb19SBen Gras.Xr memcmp 3 ,
78*2fe8fb19SBen Gras.Xr strcmp 3 ,
79*2fe8fb19SBen Gras.Xr strcoll 3 ,
80*2fe8fb19SBen Gras.Xr strxfrm 3
81*2fe8fb19SBen Gras.Sh HISTORY
82*2fe8fb19SBen GrasThe
83*2fe8fb19SBen Gras.Fn strcasecmp
84*2fe8fb19SBen Grasand
85*2fe8fb19SBen Gras.Fn strncasecmp
86*2fe8fb19SBen Grasfunctions first appeared in
87*2fe8fb19SBen Gras.Bx 4.4 .
88*2fe8fb19SBen Gras.Sh NOTES
89*2fe8fb19SBen GrasIf
90*2fe8fb19SBen Gras.Fa len
91*2fe8fb19SBen Grasis zero
92*2fe8fb19SBen Gras.Fn strncasecmp
93*2fe8fb19SBen Grasreturns always 0.
94