[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'sysutils' (#rtl)

# AnsiStrUpper

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

## Declaration

Source position: sysstrh.inc line 93

`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

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;

    Procedure Testit (S : Pchar);

    begin
     Writeln (S,' -> ',AnsiStrUpper(S))
    end;

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

Documentation generated on: Feb 26 2014