original/man3/towupper.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"   ISO/IEC 9899:1999
  15 .\"
  16 .TH TOWUPPER 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  17 .SH NAME
  18 towupper \- convert a wide character to uppercase
  19 .SH SYNOPSIS
  20 .nf
  21 .B #include <wctype.h>
  22 .sp
  23 .BI "wint_t towupper(wint_t " wc );
  24 .fi
  25 .SH DESCRIPTION
  26 The
  27 .BR towupper ()
  28 function is the wide-character equivalent of the
  29 .BR toupper (3)
  30 function.
  31 If
  32 .I wc
  33 is a wide character, it is converted to
  34 uppercase.
  35 Characters which do not have case are returned unchanged.
  36 If
  37 .IR wc
  38 is
  39 .BR WEOF ,
  40 .B WEOF
  41 is returned.
  42 .SH RETURN VALUE
  43 The
  44 .BR towupper ()
  45 function returns the uppercase equivalent of
  46 .IR wc ,
  47 or
  48 .BR WEOF
  49 if
  50 .I wc
  51 is
  52 .BR WEOF .
  53 .SH CONFORMING TO
  54 C99.
  55 .SH NOTES
  56 The behavior of
  57 .BR towupper ()
  58 depends on the
  59 .B LC_CTYPE
  60 category of the
  61 current locale.
  62 .PP
  63 This function is not very appropriate for dealing with Unicode characters,
  64 because Unicode knows about three cases: upper, lower and title case.
  65 .SH SEE ALSO
  66 .BR iswupper (3),
  67 .BR towctrans (3),
  68 .BR towlower (3)