1.\" Copyright (c) 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the American National Standards Committee X3, on Information
6.\" Processing Systems.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
--- 16 unchanged lines hidden (view full) ---
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)iscntrl.3 8.1 (Berkeley) 6/4/93
33.\" $FreeBSD: head/lib/libc/locale/iscntrl.3 232935 2012-03-13 20:02:41Z theraven $
34.\"
35.Dd July 17, 2005
36.Dt ISCNTRL 3
37.Os
38.Sh NAME
39.Nm iscntrl
40.Nd control character test
41.Sh LIBRARY
42.Lb libc
43.Sh SYNOPSIS
44.In ctype.h
45.Ft int
46.Fn iscntrl "int c"
47.Ft int
48.Fn iscntrl_l "int c" "locale_t loc"
49.Sh DESCRIPTION
50The
51.Fn iscntrl
52function tests for any control character.
53The value of the argument must be representable as an
54.Vt "unsigned char"
55or the value of
56.Dv EOF .
--- 5 unchanged lines hidden (view full) ---
62.It "\&000\ NUL \t001\ SOH \t002\ STX \t003\ ETX \t004\ EOT"
63.It "\&005\ ENQ \t006\ ACK \t007\ BEL \t010\ BS \t011\ HT"
64.It "\&012\ NL \t013\ VT \t014\ NP \t015\ CR \t016\ SO"
65.It "\&017\ SI \t020\ DLE \t021\ DC1 \t022\ DC2 \t023\ DC3"
66.It "\&024\ DC4 \t025\ NAK \t026\ SYN \t027\ ETB \t030\ CAN"
67.It "\&031\ EM \t032\ SUB \t033\ ESC \t034\ FS \t035\ GS"
68.It "\&036\ RS \t037\ US \t177\ DEL"
69.El
70.Pp
71The
72.Fn iscntrl_l
73function takes an explicit locale argument, whereas the
74.Fn iscntrl
75function uses the current global or per-thread locale.
76.Sh RETURN VALUES
77The
78.Fn iscntrl
79function returns zero if the character tests false and
80returns non-zero if the character tests true.
81.Sh COMPATIBILITY
82The
83.Bx 4.4
84extension of accepting arguments outside of the range of the
85.Vt "unsigned char"
86type in locales with large character sets is considered obsolete
87and may not be supported in future releases.
88The
89.Fn iswcntrl
90function should be used instead.
91.Sh SEE ALSO
92.Xr ctype 3 ,
93.Xr iswcntrl 3 ,
94.Xr xlocale 3 ,
95.Xr ascii 7
96.Sh STANDARDS
97The
98.Fn iscntrl
99function conforms to
100.St -isoC .
101The
102.Fn iscntrl_l
103function conforms to
104.St -p1003.1-2008 .
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the American National Standards Committee X3, on Information
6.\" Processing Systems.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
--- 16 unchanged lines hidden (view full) ---
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)iscntrl.3 8.1 (Berkeley) 6/4/93
33.\" $FreeBSD: head/lib/libc/locale/iscntrl.3 232935 2012-03-13 20:02:41Z theraven $
34.\"
35.Dd July 17, 2005
36.Dt ISCNTRL 3
37.Os
38.Sh NAME
39.Nm iscntrl
40.Nd control character test
41.Sh LIBRARY
42.Lb libc
43.Sh SYNOPSIS
44.In ctype.h
45.Ft int
46.Fn iscntrl "int c"
47.Ft int
48.Fn iscntrl_l "int c" "locale_t loc"
49.Sh DESCRIPTION
50The
51.Fn iscntrl
52function tests for any control character.
53The value of the argument must be representable as an
54.Vt "unsigned char"
55or the value of
56.Dv EOF .
--- 5 unchanged lines hidden (view full) ---
62.It "\&000\ NUL \t001\ SOH \t002\ STX \t003\ ETX \t004\ EOT"
63.It "\&005\ ENQ \t006\ ACK \t007\ BEL \t010\ BS \t011\ HT"
64.It "\&012\ NL \t013\ VT \t014\ NP \t015\ CR \t016\ SO"
65.It "\&017\ SI \t020\ DLE \t021\ DC1 \t022\ DC2 \t023\ DC3"
66.It "\&024\ DC4 \t025\ NAK \t026\ SYN \t027\ ETB \t030\ CAN"
67.It "\&031\ EM \t032\ SUB \t033\ ESC \t034\ FS \t035\ GS"
68.It "\&036\ RS \t037\ US \t177\ DEL"
69.El
70.Pp
71The
72.Fn iscntrl_l
73function takes an explicit locale argument, whereas the
74.Fn iscntrl
75function uses the current global or per-thread locale.
76.Sh RETURN VALUES
77The
78.Fn iscntrl
79function returns zero if the character tests false and
80returns non-zero if the character tests true.
81.Sh COMPATIBILITY
82The
83.Bx 4.4
84extension of accepting arguments outside of the range of the
85.Vt "unsigned char"
86type in locales with large character sets is considered obsolete
87and may not be supported in future releases.
88The
89.Fn iswcntrl
90function should be used instead.
91.Sh SEE ALSO
92.Xr ctype 3 ,
93.Xr iswcntrl 3 ,
94.Xr xlocale 3 ,
95.Xr ascii 7
96.Sh STANDARDS
97The
98.Fn iscntrl
99function conforms to
100.St -isoC .
101The
102.Fn iscntrl_l
103function conforms to
104.St -p1003.1-2008 .