Skip to content

    AnsiStrLower

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

    Declaration

    Source position: sysstrh.inc line 101

    function AnsiStrLower(Str: PAnsiChar) : PAnsiChar;

    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

    Name Description
    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,strings;

Procedure Testit (S : Pchar);

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

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