Name
COMPOSE
Synopsis
COMPOSE takes a Unicode string as input and returns that string in its fully normalized form. The specification for COMPOSE is:
FUNCTION COMPOSE (string1 IN VARCHAR2) RETURN VARCHAR2Unicode allows certain characters to be represented in multiple ways. For example, the ã character that you’ve seen throughout this chapter can be represented in the following two ways:
ã = \00E3 ã = a\0303
In the first case, \00E3 is the Unicode code point (in hexadecimal) for the character ã. In the second case, \0303 is a nonspacing Unicode character representing the addition of a ~ to the preceding character. Thus, ã is built up starting with a simple “a” and then adding the ~ on top. The complete character \00E3 is known as a precomposed character . The COMPOSE function takes decomposed strings such as “a\0303” and converts them into their composed counterparts. For example:
DECLARE
x VARCHAR2(30);
y VARCHAR2(30);
BEGIN
SELECT COMPOSE(UNISTR('a\0303 is a composed character')),
ASCIISTR(COMPOSE(UNISTR('a\0303 is a composed character')))
INTO x, y
FROM dual;
DBMS_OUTPUT.PUT_LINE(x);
DBMS_OUTPUT.PUT_LINE(y);
END;The output is:
ã is a composed character \00E3 is a composed character
Warning
In Oracle9i Release 1, COMPOSE must be called from a SQL statement; it cannot be used in a PL/SQL expression. In Oracle9i Release 2, however, you can invoke COMPOSE from a PL/SQL expression.
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access