Sign in Join
FPDoc Onlineexperiment

AnsiStrUpper function

In unit sysutils

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

Declaration

pascal
function AnsiStrUpper(Str: PAnsiChar): PAnsiChar

Description

AnsiStrUpper converts the PChar Str to uppercase characters and returns the resulting string. Note that Str itself is modified, not a copy, as in the case of AnsiUpperCase. 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: ex60

pascal
Program Example60;

{ This program demonstrates the AnsiStrUpper function }

Uses sysutils, strings;

Procedure Testit (S : Pchar);

begin
 Writeln (S,' -> ',AnsiStrUpper(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.