1 '\" te
   2 .\"
   3 .\" This file and its contents are supplied under the terms of the
   4 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   5 .\" You may only use this file in accordance with the terms of version
   6 .\" 1.0 of the CDDL.
   7 .\"
   8 .\" A full copy of the text of the CDDL should have accompanied this
   9 .\" source.  A copy of the CDDL is also available via the Internet at
  10 .\" http://www.illumos.org/license/CDDL.
  11 .\"
  12 .\"
  13 .\" Copyright (c) 2014 Joyent, Inc.  All rights reserved.
  14 .\"
  15 .TH TOWLOWER 3C "Jun 11, 2014"
  16 
  17 .SH NAME
  18 
  19 towlower, towlower_l \- transliterate upper-case wide characters to lower-case
  20 
  21 .SH SYNOPSIS
  22 
  23 .LP
  24 .nf
  25 #include <wctype.h>
  26 
  27 .BI "wint_t towlower(wint_t" wc );
  28 .BI "wint_t towlower_l(wint_t" wc, " locale_t " loc );
  29 
  30 .SH DESCRIPTION
  31 
  32 The function
  33 .BR towlower
  34 is the wide character equivalent of the function
  35 .BR tolower .
  36 It converts the upper-case wide character
  37 .I loc
  38 to the equivalent lower-case
  39 wide character, if one exists. If one does not exist, it returns
  40 .I loc
  41 unchanged.
  42 
  43 .LP
  44 The function
  45 .B towlower_l
  46 is equivalent to the function
  47 .BR towlower ,
  48 but instead of operating in the current environemnt, operates on the
  49 environment specified by
  50 .IR loc .
  51 
  52 .SH RETURN VALUES
  53 
  54 On successful completion,
  55 .B towlower()
  56 and
  57 .B towlower_l()
  58 return the lower-case character that corresponds to the argument passed.
  59 Otherwise, they return the argument unchanged.
  60 
  61 .SH ERRORS
  62 
  63 No errors are defined.
  64 
  65 .SH ATTRIBUTES
  66 .sp
  67 .TS
  68 box;
  69 c | c
  70 l | l .
  71 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  72 _
  73 Interface Stability     Standard
  74 _
  75 MT-Level        Safe
  76 .TE
  77 
  78 .SH SEE ALSO
  79 .BR duplocale (3C),
  80 .BR newlocale (3C),
  81 .BR setlocale (3C),
  82 .BR towupper (3C),
  83 .BR environ (5),
  84 .BR locale (5)