| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed |
| with this work for additional information regarding copyright |
| ownership. The ASF licenses this file to you under the Apache |
| License, Version 2.0 (the License); you may not use this file |
| except in compliance with the License. You may obtain a copy of |
| the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or |
| implied. See the License for the specific language governing |
| permissions and limitations under the License. |
| |
| Copyright 1999-2007 Rogue Wave Software, Inc. |
| --> |
| |
| <HTML> |
| <HEAD> |
| <TITLE>tolower()</TITLE> |
| <LINK REL=StyleSheet HREF="../rw.css" TYPE="text/css" TITLE="Apache stdcxx Stylesheet"></HEAD> |
| <BODY BGCOLOR=#FFFFFF> |
| <A HREF="time-put-byname.html"><IMG SRC="images/bprev.gif" WIDTH=20 HEIGHT=21 ALT="Previous file" BORDER=O></A><A HREF="noframes.html"><IMG SRC="images/btop.gif" WIDTH=56 HEIGHT=21 ALT="Top of Document" BORDER=O></A><A HREF="booktoc.html"><IMG SRC="images/btoc.gif" WIDTH=56 HEIGHT=21 ALT="Contents" BORDER=O></A><A HREF="tindex.html"><IMG SRC="images/bindex.gif" WIDTH=56 HEIGHT=21 ALT="Index page" BORDER=O></A><A HREF="toupper.html"><IMG SRC="images/bnext.gif" WIDTH=25 HEIGHT=21 ALT="Next file" BORDER=O></A><DIV CLASS="DOCUMENTNAME"><B>Apache C++ Standard Library Reference Guide</B></DIV> |
| <H2>tolower()</H2> |
| <P><B>Library:</B> <A HREF="2-6.html">Localization</A></P> |
| |
| <PRE><HR><B><I>Function</I></B><HR></PRE> |
| |
| <UL> |
| <LI><A HREF="#sec1">Local Index</A></LI> |
| <LI><A HREF="#sec2">Summary</A></LI> |
| <LI><A HREF="#sec3">Synopsis</A></LI> |
| <LI><A HREF="#sec4">Description</A></LI> |
| <LI><A HREF="#sec5">Example</A></LI> |
| <LI><A HREF="#sec6">See Also</A></LI> |
| <LI><A HREF="#sec7">Standards Conformance</A></LI> |
| </UL> |
| <A NAME="sec1"><H3>Local Index</H3></A> |
| No Entries |
| <A NAME="sec2"><H3>Summary</H3></A> |
| <P>Locale convenience function that converts a character to lower case</P> |
| <A NAME="sec3"><H3>Synopsis</H3></A> |
| |
| <PRE>#include <locale> |
| |
| namespace std { |
| template <class charT> |
| charT tolower(charT c, const locale& loc); |
| } |
| </PRE> |
| <A NAME="sec4"><H3>Description</H3></A> |
| <P>The <SAMP>tolower()</SAMP> function returns the parameter <SAMP>c</SAMP> after converting it to lower case. The conversion is made using the <SAMP>ctype</SAMP> facet from the <SAMP>locale</SAMP> parameter.</P> |
| <A NAME="sec5"><H3>Example</H3></A> |
| |
| <UL><PRE>// |
| // toupper.cpp |
| // |
| |
| #include <iomanip> // for setw |
| #include <iostream> // for cout, endl |
| |
| int main () |
| { |
| std::cout << std::oct; |
| std::cout.fill ('0'); |
| |
| // compute tolower and toupper of printable ASCII characters |
| for (int c = ' '; c != '~' + 1; ++c) |
| std::cout << "std::toupper/lower ('\\" << std::setw (3) |
| << c |
| << "', std::locale ()) = '" |
| << std::toupper (char (c), std::cout.getloc ()) |
| << "' / " |
| << std::tolower (char (c), std::cout.getloc ()) |
| << "'\n"; |
| |
| return 0; |
| } |
| |
| Program Output: |
| std::toupper/lower ('\040', std::locale ()) = ' ' / ' |
| std::toupper/lower ('\041', std::locale ()) = '!' / !' |
| std::toupper/lower ('\042', std::locale ()) = '"' / "' |
| std::toupper/lower ('\043', std::locale ()) = '#' / #' |
| std::toupper/lower ('\044', std::locale ()) = '$' / $' |
| std::toupper/lower ('\045', std::locale ()) = '%' / %' |
| std::toupper/lower ('\046', std::locale ()) = '&' / &' |
| std::toupper/lower ('\047', std::locale ()) = ''' / '' |
| std::toupper/lower ('\050', std::locale ()) = '(' / (' |
| std::toupper/lower ('\051', std::locale ()) = ')' / )' |
| std::toupper/lower ('\052', std::locale ()) = '*' / *' |
| std::toupper/lower ('\053', std::locale ()) = '+' / +' |
| std::toupper/lower ('\054', std::locale ()) = ',' / ,' |
| std::toupper/lower ('\055', std::locale ()) = '-' / -' |
| std::toupper/lower ('\056', std::locale ()) = '.' / .' |
| std::toupper/lower ('\057', std::locale ()) = '/' / /' |
| std::toupper/lower ('\060', std::locale ()) = '0' / 0' |
| std::toupper/lower ('\061', std::locale ()) = '1' / 1' |
| std::toupper/lower ('\062', std::locale ()) = '2' / 2' |
| std::toupper/lower ('\063', std::locale ()) = '3' / 3' |
| std::toupper/lower ('\064', std::locale ()) = '4' / 4' |
| std::toupper/lower ('\065', std::locale ()) = '5' / 5' |
| std::toupper/lower ('\066', std::locale ()) = '6' / 6' |
| std::toupper/lower ('\067', std::locale ()) = '7' / 7' |
| std::toupper/lower ('\070', std::locale ()) = '8' / 8' |
| std::toupper/lower ('\071', std::locale ()) = '9' / 9' |
| std::toupper/lower ('\072', std::locale ()) = ':' / :' |
| std::toupper/lower ('\073', std::locale ()) = ';' / ;' |
| std::toupper/lower ('\074', std::locale ()) = '<' / <' |
| std::toupper/lower ('\075', std::locale ()) = '=' / =' |
| std::toupper/lower ('\076', std::locale ()) = '>' / >' |
| std::toupper/lower ('\077', std::locale ()) = '?' / ?' |
| std::toupper/lower ('\100', std::locale ()) = '@' / @' |
| std::toupper/lower ('\101', std::locale ()) = 'A' / a' |
| std::toupper/lower ('\102', std::locale ()) = 'B' / b' |
| std::toupper/lower ('\103', std::locale ()) = 'C' / c' |
| std::toupper/lower ('\104', std::locale ()) = 'D' / d' |
| std::toupper/lower ('\105', std::locale ()) = 'E' / e' |
| std::toupper/lower ('\106', std::locale ()) = 'F' / f' |
| std::toupper/lower ('\107', std::locale ()) = 'G' / g' |
| std::toupper/lower ('\110', std::locale ()) = 'H' / h' |
| std::toupper/lower ('\111', std::locale ()) = 'I' / i' |
| std::toupper/lower ('\112', std::locale ()) = 'J' / j' |
| std::toupper/lower ('\113', std::locale ()) = 'K' / k' |
| std::toupper/lower ('\114', std::locale ()) = 'L' / l' |
| std::toupper/lower ('\115', std::locale ()) = 'M' / m' |
| std::toupper/lower ('\116', std::locale ()) = 'N' / n' |
| std::toupper/lower ('\117', std::locale ()) = 'O' / o' |
| std::toupper/lower ('\120', std::locale ()) = 'P' / p' |
| std::toupper/lower ('\121', std::locale ()) = 'Q' / q' |
| std::toupper/lower ('\122', std::locale ()) = 'R' / r' |
| std::toupper/lower ('\123', std::locale ()) = 'S' / s' |
| std::toupper/lower ('\124', std::locale ()) = 'T' / t' |
| std::toupper/lower ('\125', std::locale ()) = 'U' / u' |
| std::toupper/lower ('\126', std::locale ()) = 'V' / v' |
| std::toupper/lower ('\127', std::locale ()) = 'W' / w' |
| std::toupper/lower ('\130', std::locale ()) = 'X' / x' |
| std::toupper/lower ('\131', std::locale ()) = 'Y' / y' |
| std::toupper/lower ('\132', std::locale ()) = 'Z' / z' |
| std::toupper/lower ('\133', std::locale ()) = '[' / [' |
| std::toupper/lower ('\134', std::locale ()) = '\' / \' |
| std::toupper/lower ('\135', std::locale ()) = ']' / ]' |
| std::toupper/lower ('\136', std::locale ()) = '^' / ^' |
| std::toupper/lower ('\137', std::locale ()) = '_' / _' |
| std::toupper/lower ('\140', std::locale ()) = '`' / `' |
| std::toupper/lower ('\141', std::locale ()) = 'A' / a' |
| std::toupper/lower ('\142', std::locale ()) = 'B' / b' |
| std::toupper/lower ('\143', std::locale ()) = 'C' / c' |
| std::toupper/lower ('\144', std::locale ()) = 'D' / d' |
| std::toupper/lower ('\145', std::locale ()) = 'E' / e' |
| std::toupper/lower ('\146', std::locale ()) = 'F' / f' |
| std::toupper/lower ('\147', std::locale ()) = 'G' / g' |
| std::toupper/lower ('\150', std::locale ()) = 'H' / h' |
| std::toupper/lower ('\151', std::locale ()) = 'I' / i' |
| std::toupper/lower ('\152', std::locale ()) = 'J' / j' |
| std::toupper/lower ('\153', std::locale ()) = 'K' / k' |
| std::toupper/lower ('\154', std::locale ()) = 'L' / l' |
| std::toupper/lower ('\155', std::locale ()) = 'M' / m' |
| std::toupper/lower ('\156', std::locale ()) = 'N' / n' |
| std::toupper/lower ('\157', std::locale ()) = 'O' / o' |
| std::toupper/lower ('\160', std::locale ()) = 'P' / p' |
| std::toupper/lower ('\161', std::locale ()) = 'Q' / q' |
| std::toupper/lower ('\162', std::locale ()) = 'R' / r' |
| std::toupper/lower ('\163', std::locale ()) = 'S' / s' |
| std::toupper/lower ('\164', std::locale ()) = 'T' / t' |
| std::toupper/lower ('\165', std::locale ()) = 'U' / u' |
| std::toupper/lower ('\166', std::locale ()) = 'V' / v' |
| std::toupper/lower ('\167', std::locale ()) = 'W' / w' |
| std::toupper/lower ('\170', std::locale ()) = 'X' / x' |
| std::toupper/lower ('\171', std::locale ()) = 'Y' / y' |
| std::toupper/lower ('\172', std::locale ()) = 'Z' / z' |
| std::toupper/lower ('\173', std::locale ()) = '{' / {' |
| std::toupper/lower ('\174', std::locale ()) = '|' / |' |
| std::toupper/lower ('\175', std::locale ()) = '}' / }' |
| std::toupper/lower ('\176', std::locale ()) = '~' / ~' |
| </PRE></UL> |
| <A NAME="sec6"><H3>See Also</H3></A> |
| <P><SAMP><A HREF="toupper.html">toupper()</A></SAMP>, <B><I><A HREF="locale.html">locale</A></I></B>, <B><I><A HREF="ctype.html">ctype</A></I></B></P> |
| <A NAME="sec7"><H3>Standards Conformance</H3></A> |
| <P><I>ISO/IEC 14882:1998 -- International Standard for Information Systems -- Programming Language C++, Section 22.1.3.2</I></P> |
| |
| <BR> |
| <HR> |
| <A HREF="time-put-byname.html"><IMG SRC="images/bprev.gif" WIDTH=20 HEIGHT=21 ALT="Previous file" BORDER=O></A><A HREF="noframes.html"><IMG SRC="images/btop.gif" WIDTH=56 HEIGHT=21 ALT="Top of Document" BORDER=O></A><A HREF="booktoc.html"><IMG SRC="images/btoc.gif" WIDTH=56 HEIGHT=21 ALT="Contents" BORDER=O></A><A HREF="tindex.html"><IMG SRC="images/bindex.gif" WIDTH=56 HEIGHT=21 ALT="Index page" BORDER=O></A><A HREF="toupper.html"><IMG SRC="images/bnext.gif" WIDTH=20 HEIGHT=21 ALT="Next file" BORDER=O></A> |
| |
| <!-- Google Analytics tracking code --> |
| <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"> |
| </script> |
| <script type="text/javascript"> |
| _uacct = "UA-1775151-1"; |
| urchinTracker(); |
| </script> |
| <!-- end of Google Analytics tracking code --> |
| |
| </BODY> |
| </HTML> |