rtrim

`rtrim`

Library: ib_udf

Changed in: 1.5, 1.5.2

Description: Returns the input string with any trailing space characters removed. In Firebird 1.0.x, this function returns NULL if the input string is empty or NULL. In 1.5 and above it returns '' (an empty string) in these cases.

Return type: CHAR(n)

Syntax (unchanged):

rtrim (str)

Declaration:

DECLARE EXTERNAL FUNCTION rtrim
   CSTRING(255)
   RETURNS CSTRING(255) FREE_IT
   ENTRY_POINT 'IB_UDF_rtrim' MODULE_NAME 'ib_udf'

Notes

In Firebird 1.5.1 and below, the default declaration uses CSTRING(80) instead of CSTRING(255).
Depending on how you declare it (see CSTRING note), this function can accept and return strings of up to 32767 characters.