AnsiStrUpper

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

Declaration

Source position: sysstrh.inc line 101

  function AnsiStrUpper(Str: PChar) : PChar;

Description

AnsiStrUpper converts the PCharStr 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.

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
AnsiLowerCase Return a lowercase version of a string.
AnsiStrLower Convert a null-terminated string to all-lowercase characters.
AnsiUpperCase Return an uppercase version of a string, taking into account special characters.

Example

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.