The UPOS Function
The UPOS function returns an integer value that is equal to the index of the
nth UTF-8 or UTF-16 character in a character string argument that is encoded in UTF-8 or UTF-16.
The function type is integer.
General Format
Arguments
- argument-1
- Must be alphabetic, alphanumeric, national, or UTF-81.
argument-1 must contain valid UTF-8 or UTF-16 data based on its class:
- If argument-1 is of class alphabetic, alphanumeric, or UTF-8, it must contain valid UTF-8 data.
- If argument-1 is of class national, it must contain valid UTF-16 data.
- argument-2
- The nth UTF-8 or UTF-16 character to locate in argument-1. argument-2 must be a positive integer and not exceed ULENGTH(argument-1), otherwise zero is returned.
Returned Value
The returned value is an integer that is equal to the index of the nth UTF-8 or UTF-16 character (as specified by argument-2) in argument-1.