RTRIM

Trims trailing whitespace from a string.

See also TRIM, LTRIM.

Syntax

RTRIM( expr )

Arguments

Parameter

Description

expr

String expression

Returns

Returns the same type as the argument supplied.

Notes

  • When using TEXT values, SQream DB automatically trims the trailing whitespace. Using RTRIM on TEXT does not affect the result.

  • This function is equivalent to the ANSI form TRIM( TRAILING FROM expr )

  • If the value is NULL, the result is NULL.

Examples

For these examples, consider the following table and contents:

CREATE TABLE jabberwocky(line TEXT(50));

INSERT INTO jabberwocky VALUES
   ('''Twas brillig, and the slithy toves '), ('      Did gyre and gimble in the wabe: ')
   ,('All mimsy were the borogoves, '), ('      And the mome raths outgrabe. ')
   ,('"Beware the Jabberwock, my son! '), ('      The jaws that bite, the claws that catch! ')
   ,('Beware the Jubjub bird, and shun '), ('      The frumious Bandersnatch!" ');

Trimming a literal value

In this example we use || (Concatenate) to show the whitespace.

t=> SELECT '#' || RTRIM('            SQream DB            ') || '#';
rtrim
-----------------------
#            SQream DB#

Trimming a column of values

t=> SELECT ('Line: ' || line) as untrimmed, ('Line: ' || RTRIM(line) || ') as trimmed FROM jabberwocky;
untrimmed                                               | trimmed
--------------------------------------------------------+-------------------------------------------------------
Line: 'Twas brillig, and the slithy toves #             | Line: 'Twas brillig, and the slithy toves#
Line:       Did gyre and gimble in the wabe: #          | Line:       Did gyre and gimble in the wabe:#
Line: All mimsy were the borogoves, #                   | Line: All mimsy were the borogoves,#
Line:       And the mome raths outgrabe. #              | Line:       And the mome raths outgrabe.#
Line: "Beware the Jabberwock, my son! #                 | Line: "Beware the Jabberwock, my son!#
Line:       The jaws that bite, the claws that catch! # | Line:       The jaws that bite, the claws that catch!#
Line: Beware the Jubjub bird, and shun #                | Line: Beware the Jubjub bird, and shun#
Line:       The frumious Bandersnatch!" #               | Line:       The frumious Bandersnatch!"#