efun: trim

SYNOPSIS:

        #include <sys/strings.h>

        string trim (string s)
        string trim (string s, int where)
        string trim (string s, int where, int ch)
        string trim (string s, int where, string ch)

DESCRIPTION:

        Remove all leading and trailing characters <ch> from the string
        <s> and return the new string.

        <ch> may be given as a single character, or a string of characters.
        If <ch> is not given, it defaults to the whitespace " \t".

        <where> can be used to modify where the characters are removed:

          TRIM_LEFT  (1):      remove the leading characters
          TRIM_RIGHT (2):      remove the trailing characters
          TRIM_BOTH  (3 or 0): remove both leading and trailing characters

EXAMPLE:

        trim("   1234   ")                  --> "1234"
        trim("   1234   ", TRIM_RIGHT)      --> "   1234"
        trim("   1234   ", TRIM_BOTH, " 1") --> "234"

HISTORY:

        Introduced in LDMud 3.2.7.

SEE ALSO:

	
	regreplace(E)