Firebird Documentation IndexFirebird 1.5 Language Ref. UpdateExternal functions (UDFs) → rtrim
Firebird Home Firebird Home Prev: rpadFirebird Documentation IndexUp: External functions (UDFs)Next: sdow

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.

Prev: rpadFirebird Documentation IndexUp: External functions (UDFs)Next: sdow
Firebird Documentation IndexFirebird 1.5 Language Ref. UpdateExternal functions (UDFs) → rtrim