Annotation of 43BSDReno/lib/libc/string/strcmp.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" Chris Torek.
                      6: .\"
                      7: .\" Redistribution and use in source and binary forms are permitted provided
                      8: .\" that: (1) source distributions retain this entire copyright notice and
                      9: .\" comment, and (2) distributions including binaries display the following
                     10: .\" acknowledgement:  ``This product includes software developed by the
                     11: .\" University of California, Berkeley and its contributors'' in the
                     12: .\" documentation or other materials provided with the distribution and in
                     13: .\" all advertising materials mentioning features or use of this software.
                     14: .\" Neither the name of the University nor the names of its contributors may
                     15: .\" be used to endorse or promote products derived from this software without
                     16: .\" specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"    @(#)strcmp.3    5.3 (Berkeley) 6/24/90
                     22: .\"
                     23: .TH STRCMP 3 "June 24, 1990"
                     24: .UC 4
                     25: .SH NAME
                     26: strcmp \- compare strings
                     27: .SH SYNOPSIS
                     28: .nf
                     29: .ft B
                     30: #include <string.h>
                     31: 
                     32: int
                     33: strcmp(const char *s1, const char *s2);
                     34: 
                     35: int
                     36: strncmp(const char *s1, const char *s2, size_t len);
                     37: .ft R
                     38: .fi
                     39: .SH DESCRIPTION
                     40: .B Strcmp
                     41: and
                     42: .B strncmp
                     43: compare null-terminated strings
                     44: .I s1
                     45: and
                     46: .I s2
                     47: and return an integer greater than, equal to, or less than 0,
                     48: according as
                     49: .I s1
                     50: is lexicographically greater than, equal to, or less than
                     51: .IR s2 .
                     52: The comparison is done using unsigned characters, so that '\e200'
                     53: is greater than '\e0'.
                     54: .PP
                     55: .I Strncmp
                     56: compares at most
                     57: .I len
                     58: characters.
                     59: .SH SEE ALSO
                     60: bcmp(3), memcmp(3), strcasecmp(3), strcoll(3), strxfrm(3)
                     61: .SH STANDARDS
                     62: .B Strcmp
                     63: and
                     64: .B strncmp
                     65: conform to ANSI X3.159-1989 (``ANSI C'').

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.