Sign in Join
FPDoc Onlineexperiment

AnsiStrLower function

In unit sysutils

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

Declaration

pascal
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.

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

Errors

None.

See also

Example: ex59

pascal
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.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.