Oracle / PLSQL: RTRIM Function

This Oracle tutorial explains how to use the Oracle/PLSQL RTRIM function with syntax and examples.

Description

The Oracle/PLSQL RTRIM function removes all specified characters from the right-hand side of a string.

Syntax

The syntax for the RTRIM function in Oracle/PLSQL is:

RTRIM( string1 [, trim_string ] )

Parameters or Arguments

string1

The string to trim the characters from the right-hand side.

trim_string

Optional. The string that will be removed from the right-hand side of string1. If this parameter is omitted, the RTRIM function will remove all trailing spaces from string1.

Returns

The RTRIM function returns a string value.

Note

• See also the LTRIM and TRIM functions.

Applies To

The RTRIM function can be used in the following versions of Oracle/PLSQL:

• Oracle 12c, Oracle 11g, Oracle 10g, Oracle 9i, Oracle 8i

Example

Let's look at some Oracle RTRIM function examples and explore how to use the RTRIM function in Oracle/PLSQL.

For example:

RTRIM('aodb ')
Output: 'aodb'

RTRIM('aodb ', ' ')
Output: 'aodb'

RTRIM('123000', '0')
Output: '123'

RTRIM('Aodb123123', '123')
Output: 'Aodb'

RTRIM('123Aodb123', '123')
Output: '123Aodb'

RTRIM('Aodbxyxzyyy', 'xyz')
Output: 'Aodb'

RTRIM('Aodb6372', '0123456789')
Output: 'Aodb'

The RTRIM function may appear to remove patterns, but this is not the case as demonstrated in the following example.

RTRIM('Aodbxyxxyzyyyxx', 'xyz')
Output: 'Aodb'

It actually removes the individual occurrences of 'x', 'y', and 'z', as opposed to the pattern of 'xyz'.

The RTRIM function can also be used to remove all trailing numbers as demonstrated in the next example.

RTRIM('Aodb6372', '0123456789')
Output: 'Aodb'

In this example, every number combination from 0 to 9 has been listed in the trim_string parameter. By doing this, it does not matter the order that the numbers appear in string1, all trailing numbers will be removed by the RTRIM function.