xref: /minix3/lib/libc/string/strlen.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 and the American National Standards Committee X3,
6*2fe8fb19SBen Gras.\" on Information Processing Systems.
7*2fe8fb19SBen Gras.\"
8*2fe8fb19SBen Gras.\" Redistribution and use in source and binary forms, with or without
9*2fe8fb19SBen Gras.\" modification, are permitted provided that the following conditions
10*2fe8fb19SBen Gras.\" are met:
11*2fe8fb19SBen Gras.\" 1. Redistributions of source code must retain the above copyright
12*2fe8fb19SBen Gras.\"    notice, this list of conditions and the following disclaimer.
13*2fe8fb19SBen Gras.\" 2. Redistributions in binary form must reproduce the above copyright
14*2fe8fb19SBen Gras.\"    notice, this list of conditions and the following disclaimer in the
15*2fe8fb19SBen Gras.\"    documentation and/or other materials provided with the distribution.
16*2fe8fb19SBen Gras.\" 3. Neither the name of the University nor the names of its contributors
17*2fe8fb19SBen Gras.\"    may be used to endorse or promote products derived from this software
18*2fe8fb19SBen Gras.\"    without specific prior written permission.
19*2fe8fb19SBen Gras.\"
20*2fe8fb19SBen Gras.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21*2fe8fb19SBen Gras.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22*2fe8fb19SBen Gras.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23*2fe8fb19SBen Gras.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24*2fe8fb19SBen Gras.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25*2fe8fb19SBen Gras.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26*2fe8fb19SBen Gras.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27*2fe8fb19SBen Gras.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28*2fe8fb19SBen Gras.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29*2fe8fb19SBen Gras.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30*2fe8fb19SBen Gras.\" SUCH DAMAGE.
31*2fe8fb19SBen Gras.\"
32*2fe8fb19SBen Gras.\"     from: @(#)strlen.3	8.1 (Berkeley) 6/4/93
33*2fe8fb19SBen Gras.\"	$NetBSD: strlen.3,v 1.9 2009/05/01 17:27:01 perry Exp $
34*2fe8fb19SBen Gras.\"
35*2fe8fb19SBen Gras.Dd May 1, 2009
36*2fe8fb19SBen Gras.Dt STRLEN 3
37*2fe8fb19SBen Gras.Os
38*2fe8fb19SBen Gras.Sh NAME
39*2fe8fb19SBen Gras.Nm strlen ,
40*2fe8fb19SBen Gras.Nm strnlen
41*2fe8fb19SBen Gras.Nd find length of string
42*2fe8fb19SBen Gras.Sh LIBRARY
43*2fe8fb19SBen Gras.Lb libc
44*2fe8fb19SBen Gras.Sh SYNOPSIS
45*2fe8fb19SBen Gras.In string.h
46*2fe8fb19SBen Gras.Ft size_t
47*2fe8fb19SBen Gras.Fn strlen "const char *s"
48*2fe8fb19SBen Gras.Ft size_t
49*2fe8fb19SBen Gras.Fn strnlen "const char *s" "size_t maxlen"
50*2fe8fb19SBen Gras.Sh DESCRIPTION
51*2fe8fb19SBen GrasThe
52*2fe8fb19SBen Gras.Fn strlen
53*2fe8fb19SBen Grasfunction
54*2fe8fb19SBen Grascomputes the length of the string
55*2fe8fb19SBen Gras.Fa s .
56*2fe8fb19SBen Gras.Pp
57*2fe8fb19SBen GrasThe
58*2fe8fb19SBen Gras.Fn strnlen
59*2fe8fb19SBen Grasfunction attempts to compute the length of
60*2fe8fb19SBen Gras.Fa s ,
61*2fe8fb19SBen Grasbut never scans beyond the first
62*2fe8fb19SBen Gras.Fa maxlen
63*2fe8fb19SBen Grasbytes of
64*2fe8fb19SBen Gras.Fa s .
65*2fe8fb19SBen Gras.Sh RETURN VALUES
66*2fe8fb19SBen GrasThe
67*2fe8fb19SBen Gras.Fn strlen
68*2fe8fb19SBen Grasfunction
69*2fe8fb19SBen Grasreturns
70*2fe8fb19SBen Grasthe number of characters that precede the
71*2fe8fb19SBen Grasterminating
72*2fe8fb19SBen Gras.Dv NUL
73*2fe8fb19SBen Grascharacter.
74*2fe8fb19SBen Gras.Pp
75*2fe8fb19SBen GrasThe
76*2fe8fb19SBen Gras.Fn strnlen
77*2fe8fb19SBen Grasfunction returns either the same result as
78*2fe8fb19SBen Gras.Fn strlen
79*2fe8fb19SBen Grasor
80*2fe8fb19SBen Gras.Fa maxlen ,
81*2fe8fb19SBen Graswhichever is smaller.
82*2fe8fb19SBen Gras.Sh SEE ALSO
83*2fe8fb19SBen Gras.Xr string 3 ,
84*2fe8fb19SBen Gras.Xr wcslen 3 ,
85*2fe8fb19SBen Gras.Xr wcswidth 3
86*2fe8fb19SBen Gras.Sh STANDARDS
87*2fe8fb19SBen GrasThe
88*2fe8fb19SBen Gras.Fn strlen
89*2fe8fb19SBen Grasfunction
90*2fe8fb19SBen Grasconforms to
91*2fe8fb19SBen Gras.St -isoC .
92*2fe8fb19SBen GrasThe
93*2fe8fb19SBen Gras.Fn strnlen
94*2fe8fb19SBen Grasfunction conforms to
95*2fe8fb19SBen Gras.St -p1003.1-2008 .
96