[Overview][Resource strings][Constants][Types][Procedures and functions][Index] | Reference for unit 'unicodedata' (#rtl)

# UnicodeToUpper

Transform unicode string to uppercase

## Declaration

Source position: unicodedata.pas line 482

`function UnicodeToUpper(`
`const AString: UnicodeString;`
`const AIgnoreInvalidSequence: Boolean;`
`out AResultString: UnicodeString`
`):Integer;`

## Arguments

`AString` |  | String to convert to uppercase.
`AIgnoreInvalidSequence` |  | Set to true to ignore invalid characters.
`AResultString` |  | Uppercase equivalent of AString

## Function result

Zero if all went well, nonzero indicates an error.

## Description

UnicodeToUpper transforms a UTF16 unicode string AString to its uppercase equivalent and returns this in AResultString. If the transformation was successful, then the function returns 0. A nonzero return value means an error occurred. AResultString will remain untouched in that case.

If a character in AString cannot be found in the unicode data tables, an error will be reported, unless AIgnoreInvalidSequence is set to True, in which case the character will be copied as-is to the output.

Unicode collation data can be loaded using RegisterCollation or LoadCollation

## Errors

On error, a nonzero value will be returned.

## See also

UnicodeToLower |  | Transform unicode string to lowercase
RegisterCollation |  | Register a new collation
LoadCollation |  | Load a binary collation data file from file

Documentation generated on: May 14 2021