[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'sysutils' (#rtl)

# AnsiStrLower

Convert a null-terminated string to all-lowercase characters.

## Declaration

Source position: sysstrh.inc line 98

`function AnsiStrLower(`
`Str: PChar`
`):PChar;`

## Description

AnsiStrLower converts the PChar Str to lowercase characters and returns the resulting pchar. Note that Str itself is modified, not a copy, as in the case of AnsiLowerCase. It takes into account the operating system language settings when doing this, so special characters are converted correctly as well.

Remark: | A widestring manager must be installed in order for this function to work correctly with various character sets.

## Errors

None.

## See also

AnsiStrUpper |  | Convert a null-terminated string to all-uppercase characters.
AnsiLowerCase |  | Return a lowercase version of a string.

## Example

    Program Example59;

    { This program demonstrates the AnsiStrLower function }

    Uses sysutils;

    Procedure Testit (S : Pchar);

    begin
     Writeln (S,' -> ',AnsiStrLower(S))
    end;

    Begin
      Testit('AN UPPERCASE STRING');
      Testit('Some mixed STring');
      Testit('a lowercase string');
    End.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.