~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 "ISPRINT" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
1 by Francesco Paolo Lovergine
rules: linking manpages-posix not manpages.
3
.\" isprint 
4
.SH NAME
5
isprint \- test for a printable character
6
.SH SYNOPSIS
7
.LP
8
\fB#include <ctype.h>
9
.br
10
.sp
11
int isprint(int\fP \fIc\fP\fB);
12
.br
13
\fP
14
.SH DESCRIPTION
15
.LP
16
The \fIisprint\fP() function shall test whether \fIc\fP is a character
17
of class \fBprint\fP in the program's current locale;
18
see the Base Definitions volume of IEEE\ Std\ 1003.1-2001, Chapter
19
7, Locale.
20
.LP
21
The \fIc\fP argument is an \fBint\fP, the value of which the application
22
shall ensure is a character representable as an
23
\fBunsigned char\fP or equal to the value of the macro EOF. If the
24
argument has any other value, the behavior is undefined.
25
.SH RETURN VALUE
26
.LP
27
The \fIisprint\fP() function shall return non-zero if \fIc\fP is a
28
printable character; otherwise, it shall return 0.
29
.SH ERRORS
30
.LP
31
No errors are defined.
32
.LP
33
\fIThe following sections are informative.\fP
34
.SH EXAMPLES
35
.LP
36
None.
37
.SH APPLICATION USAGE
38
.LP
39
To ensure applications portability, especially across natural languages,
40
only this function and those listed in the SEE ALSO
41
section should be used for character classification.
42
.SH RATIONALE
43
.LP
44
None.
45
.SH FUTURE DIRECTIONS
46
.LP
47
None.
48
.SH SEE ALSO
49
.LP
50
\fIisalnum\fP() , \fIisalpha\fP() , \fIiscntrl\fP() , \fIisdigit\fP()
51
, \fIisgraph\fP() ,
52
\fIislower\fP() , \fIispunct\fP() , \fIisspace\fP() , \fIisupper\fP()
53
, \fIisxdigit\fP() ,
54
\fIsetlocale\fP() , the Base Definitions volume of IEEE\ Std\ 1003.1-2001,
55
Chapter 7, Locale, \fI<ctype.h>\fP
56
.SH COPYRIGHT
57
Portions of this text are reprinted and reproduced in electronic form
58
from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
59
-- Portable Operating System Interface (POSIX), The Open Group Base
60
Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
61
Electrical and Electronics Engineers, Inc and The Open Group. In the
62
event of any discrepancy between this version and the original IEEE and
63
The Open Group Standard, the original IEEE and The Open Group Standard
64
is the referee document. The original Standard can be obtained online at
65
http://www.opengroup.org/unix/online.html .