Annotation of 43BSDReno/lib/libc/string/strstr.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
                      8: .\" provided that: (1) source distributions retain this entire copyright
                      9: .\" notice and comment, and (2) distributions including binaries display
                     10: .\" the following acknowledgement:  ``This product includes software
                     11: .\" developed by the University of California, Berkeley and its contributors''
                     12: .\" in the documentation or other materials provided with the distribution
                     13: .\" and in all advertising materials mentioning features or use of this
                     14: .\" software. Neither the name of the University nor the names of its
                     15: .\" contributors may be used to endorse or promote products derived
                     16: .\" from this software without specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     18: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     19: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"    @(#)strstr.3    5.1 (Berkeley) 5/15/90
                     22: .\"
                     23: .TH STRSTR 3 "May 15, 1990"
                     24: .UC 7
                     25: .SH NAME
                     26: strstr \- locate a substring in a string
                     27: .SH SYNOPSIS
                     28: .nf
                     29: .ft B
                     30: #include <string.h>
                     31: 
                     32: char *
                     33: strstr(const char *big, const char *little);
                     34: .ft R
                     35: .fi
                     36: .SH DESCRIPTION
                     37: .B Strstr
                     38: locates the first occurrence of the null-terminated string
                     39: .I little
                     40: in the null-terminated string
                     41: .IR big .
                     42: If
                     43: .I little
                     44: is the empty string,
                     45: .B strstr
                     46: returns
                     47: .IR big ;
                     48: if
                     49: .I little
                     50: occurs nowhere in
                     51: .IR big ,
                     52: .B strstr
                     53: returns NULL;
                     54: otherwise
                     55: .B strstr
                     56: returns a pointer to the first character of the first occurrence of
                     57: .IR little .
                     58: .SH SEE ALSO
                     59: index(3), memchr(3), rindex(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3),
                     60: strsep(3), strspn(3), strtok(3)
                     61: .SH STANDARDS
                     62: .B Strstr
                     63: conforms 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.