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)
