string-trim

Type:	-	function (subr)
Source:	-	xlstr.c

Syntax

(string-trim trim-stuff string)

trim-stuff - a string expression
string - a string expression
returns - a trimed copy of the string

Description

The 'string-trim' function takes the 'trim-stuff' characters and removes them from both ends of the 'string'. The 'trim-stuff' characters are an un-ordered set of characters to be removed, so any character that occurs in 'trim-stuff' is removed if it appears in 'string'. A new string is created and returned as the result of this function.

Examples

(string-trim "." "....foo....")     ; returns "foo"
(string-trim "<>" "<<<<bar>>>>")    ; returns "bar"
(string-trim "(.)" "..(12.34)..")   ; returns "12.34"

Common Lisp: Common LISP also supports a list of characters as a valid 'trim-stuff' argument. An example:

(string-trim '(#\Tab #\Newline) mystring)

XLISP does not support non-string parameters. Porting from XLISP will be no problem, but modifications will be necessary if porting from Common LISP code which uses a list of characters.

See the string-trim function in the XLISP 2.0 manual.

  Back to Top