10d5acd74SJohn Marino.\" Copyright (c) 1991, 1993 20d5acd74SJohn Marino.\" The Regents of the University of California. All rights reserved. 30d5acd74SJohn Marino.\" 40d5acd74SJohn Marino.\" This code is derived from software contributed to Berkeley by 50d5acd74SJohn Marino.\" the American National Standards Committee X3, on Information 60d5acd74SJohn Marino.\" Processing Systems. 70d5acd74SJohn Marino.\" 80d5acd74SJohn Marino.\" Redistribution and use in source and binary forms, with or without 90d5acd74SJohn Marino.\" modification, are permitted provided that the following conditions 100d5acd74SJohn Marino.\" are met: 110d5acd74SJohn Marino.\" 1. Redistributions of source code must retain the above copyright 120d5acd74SJohn Marino.\" notice, this list of conditions and the following disclaimer. 130d5acd74SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright 140d5acd74SJohn Marino.\" notice, this list of conditions and the following disclaimer in the 150d5acd74SJohn Marino.\" documentation and/or other materials provided with the distribution. 16*c66c7e2fSzrj.\" 3. Neither the name of the University nor the names of its contributors 170d5acd74SJohn Marino.\" may be used to endorse or promote products derived from this software 180d5acd74SJohn Marino.\" without specific prior written permission. 190d5acd74SJohn Marino.\" 200d5acd74SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 210d5acd74SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 220d5acd74SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 230d5acd74SJohn Marino.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 240d5acd74SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 250d5acd74SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 260d5acd74SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 270d5acd74SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 280d5acd74SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 290d5acd74SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 300d5acd74SJohn Marino.\" SUCH DAMAGE. 310d5acd74SJohn Marino.\" 320d5acd74SJohn Marino.\" @(#)isupper.3 8.1 (Berkeley) 6/4/93 330d5acd74SJohn Marino.\" $FreeBSD: head/lib/libc/locale/isupper.3 233992 2012-04-07 09:05:30Z joel $ 340d5acd74SJohn Marino.\" 354e81684dSSascha Wildner.Dd December 25, 2013 360d5acd74SJohn Marino.Dt ISUPPER 3 370d5acd74SJohn Marino.Os 380d5acd74SJohn Marino.Sh NAME 39382f042fSSascha Wildner.Nm isupper , 40382f042fSSascha Wildner.Nm isupper_l 410d5acd74SJohn Marino.Nd upper-case character test 420d5acd74SJohn Marino.Sh LIBRARY 430d5acd74SJohn Marino.Lb libc 440d5acd74SJohn Marino.Sh SYNOPSIS 450d5acd74SJohn Marino.In ctype.h 460d5acd74SJohn Marino.Ft int 470d5acd74SJohn Marino.Fn isupper "int c" 48382f042fSSascha Wildner.Ft int 494e81684dSSascha Wildner.Ft isupper_l "int c" "locale_t locale" 500d5acd74SJohn Marino.Sh DESCRIPTION 510d5acd74SJohn MarinoThe 520d5acd74SJohn Marino.Fn isupper 534e81684dSSascha Wildnerand 544e81684dSSascha Wildner.Fn isupper_l 554e81684dSSascha Wildnerfunctions tests for any upper-case letter. 560d5acd74SJohn MarinoThe value of the argument must be representable as an 570d5acd74SJohn Marino.Vt "unsigned char" 580d5acd74SJohn Marinoor the value of 590d5acd74SJohn Marino.Dv EOF . 600d5acd74SJohn Marino.Pp 610d5acd74SJohn MarinoIn the ASCII character set, this includes the following characters 620d5acd74SJohn Marino(with their numeric values shown in octal): 630d5acd74SJohn Marino.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ 640d5acd74SJohn Marino.It "\&101\ ``A''" Ta "102\ ``B''" Ta "103\ ``C''" Ta "104\ ``D''" Ta "105\ ``E''" 650d5acd74SJohn Marino.It "\&106\ ``F''" Ta "107\ ``G''" Ta "110\ ``H''" Ta "111\ ``I''" Ta "112\ ``J''" 660d5acd74SJohn Marino.It "\&113\ ``K''" Ta "114\ ``L''" Ta "115\ ``M''" Ta "116\ ``N''" Ta "117\ ``O''" 670d5acd74SJohn Marino.It "\&120\ ``P''" Ta "121\ ``Q''" Ta "122\ ``R''" Ta "123\ ``S''" Ta "124\ ``T''" 680d5acd74SJohn Marino.It "\&125\ ``U''" Ta "126\ ``V''" Ta "127\ ``W''" Ta "130\ ``X''" Ta "131\ ``Y''" 690d5acd74SJohn Marino.It "\&132\ ``Z''" Ta \& Ta \& Ta \& Ta \& 700d5acd74SJohn Marino.El 71382f042fSSascha Wildner.Pp 724e81684dSSascha WildnerThe _l-suffixed version takes an explicit 734e81684dSSascha Wildner.Fa locale 744e81684dSSascha Wildnerargument, whereas the 75382f042fSSascha Wildnernon-suffixed version uses the current global or per-thread locale. 760d5acd74SJohn Marino.Sh RETURN VALUES 770d5acd74SJohn MarinoThe 780d5acd74SJohn Marino.Fn isupper 794e81684dSSascha Wildnerand 804e81684dSSascha Wildner.Fn isupper_l 814e81684dSSascha Wildnerfunctions return zero if the character tests false and 820d5acd74SJohn Marinoreturns non-zero if the character tests true. 830d5acd74SJohn Marino.Sh COMPATIBILITY 840d5acd74SJohn MarinoThe 850d5acd74SJohn Marino.Bx 4.4 860d5acd74SJohn Marinoextension of accepting arguments outside of the range of the 870d5acd74SJohn Marino.Vt "unsigned char" 880d5acd74SJohn Marinotype in locales with large character sets is considered obsolete 890d5acd74SJohn Marinoand may not be supported in future releases. 900d5acd74SJohn MarinoThe 910d5acd74SJohn Marino.Fn iswupper 924e81684dSSascha Wildnerand 934e81684dSSascha Wildner.Fn iswupper_l 944e81684dSSascha Wildnerfunctions should be used instead. 950d5acd74SJohn Marino.Sh SEE ALSO 960d5acd74SJohn Marino.Xr ctype 3 , 97382f042fSSascha Wildner.Xr ctype_l 3 , 980d5acd74SJohn Marino.Xr iswupper 3 , 994e81684dSSascha Wildner.Xr iswupper_l 3 , 1000d5acd74SJohn Marino.Xr toupper 3 , 101382f042fSSascha Wildner.Xr xlocale 3 , 1020d5acd74SJohn Marino.Xr ascii 7 1030d5acd74SJohn Marino.Sh STANDARDS 1040d5acd74SJohn MarinoThe 1050d5acd74SJohn Marino.Fn isupper 1060d5acd74SJohn Marinofunction conforms to 1070d5acd74SJohn Marino.St -isoC . 1084e81684dSSascha WildnerThe 1094e81684dSSascha Wildner.Fn isupper_l 1104e81684dSSascha Wildnerfunction conforms to 1114e81684dSSascha Wildner.St -p1003.1-2008 . 112