~ubuntu-branches/ubuntu/precise/manpages-posix/precise

1 by Francesco Paolo Lovergine
rules: linking manpages-posix not manpages.
1
.\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved 
2 by Francesco Paolo Lovergine
* Alligned to linux main manpages edition.
2
.TH "STRCHR" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
1 by Francesco Paolo Lovergine
rules: linking manpages-posix not manpages.
3
.\" strchr 
4
.SH NAME
5
strchr \- string scanning operation
6
.SH SYNOPSIS
7
.LP
8
\fB#include <string.h>
9
.br
10
.sp
11
char *strchr(const char *\fP\fIs\fP\fB, int\fP \fIc\fP\fB);
12
.br
13
\fP
14
.SH DESCRIPTION
15
.LP
16
The \fIstrchr\fP() function shall locate the first occurrence of \fIc\fP
17
(converted to a \fBchar\fP) in the string pointed to
18
by \fIs\fP. The terminating null byte is considered to be part of
19
the string.
20
.SH RETURN VALUE
21
.LP
22
Upon completion, \fIstrchr\fP() shall return a pointer to the byte,
23
or a null pointer if the byte was not found.
24
.SH ERRORS
25
.LP
26
No errors are defined.
27
.LP
28
\fIThe following sections are informative.\fP
29
.SH EXAMPLES
30
.LP
31
None.
32
.SH APPLICATION USAGE
33
.LP
34
None.
35
.SH RATIONALE
36
.LP
37
None.
38
.SH FUTURE DIRECTIONS
39
.LP
40
None.
41
.SH SEE ALSO
42
.LP
43
\fIstrrchr\fP() , the Base Definitions volume of IEEE\ Std\ 1003.1-2001,
44
\fI<string.h>\fP
45
.SH COPYRIGHT
46
Portions of this text are reprinted and reproduced in electronic form
47
from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
48
-- Portable Operating System Interface (POSIX), The Open Group Base
49
Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
50
Electrical and Electronics Engineers, Inc and The Open Group. In the
51
event of any discrepancy between this version and the original IEEE and
52
The Open Group Standard, the original IEEE and The Open Group Standard
53
is the referee document. The original Standard can be obtained online at
54
http://www.opengroup.org/unix/online.html .