xpfStringToUppercaseEx

Owned by Former user (Deleted)
Last updated: May 11, 2018 by Former user (Deleted)
2 min read
FUNCTION xpfStringToUppercaseEx (sourceString                : STRING;
                                 options                     : INTEGER;
                                 extendedLowercaseCharacters : STRING)
                                 uppercaseString             : STRING;

This function will return an upper case string from a possible "mixed lower case/upper case" string. The xpfStringToUppercaseEx() function is an extended version of the xpfStringToUpperCase() and xpxStringToUpperCase() functions. The extension is that a defined set of lower case characters will be converted to upper case. It is assumed that the actual upper case value of the extended lower case characters, have the ASCII value (lowerCaseValue - 31). This function has variable number of arguments, i.e., it can be invoked with minimum 1 argument and maximum 3 arguments.

 

Arguments

1TypeNameComment
2
STRING
sourceString
The actual string in possibly "mixed lower / upper case" format that will be returned in upper case format
3
INTEGER
optionsOptional argument. Default value is INDETERMINATE (?)
4
STRING
extendedLowercaseCharactersOptional argument. Default value is INDETERMINATE (?). Specifies a set of lower case characters for this operation

Return Value

 

TypeNameComment
STRINGuppercaseStringThe resulting upper case string will be returned when the function is successfully performed. The value INDETERMINATE (?) will be returned when the function fails. Exception handling should be used to handle error conditions in the actual xpfStringToUppercaseEx() operation.

Options

 OptionComment
1xpxSYSTEM_DEFINED_EXTENSIONUse the system defined extra lower case characters in the operation. The system defined extra lower case characters is set by the EDM_EXTENDED_LOWERCASE_CHARACTERS configuration variable.

 

Example

str := xpfStringToUppercaseEx(str, ?, "æøå"); -- to have correct upper case for all letters of Norwegian alphabet
str := xpfStringToUppercaseEx(str, xpxSYSTEM_DEFINED_EXTENSION, ?); -- the same result if system variable EDM_EXTENDED_LOWERCASE_CHARACTERS = 'æøå'

 

See also

Filter by label

There are no items with the selected labels at this time.

Â