View source code Display the source code in std/ascii.d from which this page was generated on github. Improve this page Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone. Page wiki View or edit the community-maintained wiki page associated with this page.

Function std.ascii.toLower

Converts an ASCII letter to lowercase.

Prototype

auto toLower(C)(
  C c
)
if (is(C : dchar));

Parameters

NameDescription
c A character of any type that implicitly converts to dchar. In the case where it's a built-in type, or an enum of a built-in type, Unqual!(OriginalType!C) is returned, whereas if it's a user-defined type, dchar is returned.

Returns

The corresponding lowercase letter, if c is an uppercase ASCII character, otherwise c itself.

Example

assert(toLower('a') == 'a');
assert(toLower('A') == 'a');
assert(toLower('#') == '#');

// N.B.: Non-ASCII Unicode uppercase letters are not converted.
assert(toLower('Á') == 'Á');

Authors

Walter Bright and Jonathan M Davis

License

Boost License 1.0.

Comments