Skip to content

    AnsiStrUpper

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

    Declaration

    Source position: sysstrh.inc line 102

    function AnsiStrUpper(Str: PAnsiChar) : PAnsiChar;

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

    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.