mozilla

Revision 359503 of String.prototype.toLocaleLowerCase()

  • Revision slug: JavaScript/Reference/Global_Objects/String/toLocaleLowerCase
  • Revision title: String.toLocaleLowerCase
  • Revision id: 359503
  • Created:
  • Creator: ethertank
  • Is current revision? No
  • Comment syntax, code

Revision Content

Summary

Returns the calling string value converted to lower case, according to any locale-specific case mappings.

Method of String
Implemented in JavaScript 1.2
ECMAScript Edition ECMAScript 1st Edition

Syntax

string.toLocaleLowerCase()

Parameters

None.

Description

The toLocaleLowerCase method returns the value of the string converted to lower case according to any locale-specific case mappings. toLocaleLowerCase does not affect the value of the string itself. In most cases, this will produce the same result as toLowerCase(), but for some locales, such as Turkish, whose case mappings do not follow the default case mappings in Unicode, there may be a different result.

Examples

Example: Using toLocaleLowerCase

The following example displays the string "alphabet":

var upperText = "ALPHABET";

document.write( upperText.toLocaleLowerCase() );

See also

Revision Source

<h2 id="Summary">Summary</h2>
<p>Returns the calling string value converted to lower case, according to any locale-specific case mappings.</p>
<table class="standard-table">
  <thead>
    <tr>
      <th class="header" colspan="2">Method of <a href="/en-US/docs/JavaScript/Reference/Global_Objects/String"><code>String</code></a></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Implemented in</td>
      <td>JavaScript 1.2</td>
    </tr>
    <tr>
      <td>ECMAScript Edition</td>
      <td>ECMAScript 1st Edition</td>
    </tr>
  </tbody>
</table>

<h2 id="Syntax" name="Syntax">Syntax</h2>
<pre class="syntaxbox">
<code><var>string</var>.toLocaleLowerCase()</code></pre>

<h3 id="Parameters" name="Parameters">Parameters</h3>
<p>None.</p>
<h2 id="Description" name="Description">Description</h2>
<p>The <code>toLocaleLowerCase</code> method returns the value of the string converted to lower case according to any locale-specific case mappings. <code>toLocaleLowerCase</code> does not affect the value of the string itself. In most cases, this will produce the same result as <a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/toLowerCase" title="JavaScript/Reference/Global_Objects/String/toLowerCase">toLowerCase()</a>, but for some locales, such as Turkish, whose case mappings do not follow the default case mappings in Unicode, there may be a different result.</p>
<h2 id="Examples" name="Examples">Examples</h2>
<h3 id="Example:_Using_toUpperCase" name="Example:_Using_toUpperCase">Example: Using <code>toLocaleLowerCase</code></h3>
<p>The following example displays the string "alphabet":</p>
<pre class="brush:js">
var upperText = "ALPHABET";

document.write( upperText.toLocaleLowerCase() );</pre>
<h2 id="See_also">See also</h2>
<ul>
  <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/toLowerCase" title="JavaScript/Reference/Global_Objects/String/toLowerCase">toLowerCase()</a></li>
</ul>
Revert to this revision