NAME

       textutil::string - Procedures to manipulate texts and strings.

SYNOPSIS

       package require Tcl  8.2

       package require textutil::string  ?0.8?

       ::textutil::string::chop string

       ::textutil::string::tail string

       ::textutil::string::cap string

       ::textutil::string::capEachWord string

       ::textutil::string::uncap string

       ::textutil::string::longestCommonPrefixList list

       ::textutil::string::longestCommonPrefix ?string...?

________________________________________________________________________________________________________________

DESCRIPTION

       The package textutil::string provides miscellaneous string manipulation commands.

       The complete set of procedures is described below.

       ::textutil::string::chop string
              A convenience command. Removes the last character of string and returns the shortened string.

       ::textutil::string::tail string
              A convenience command. Removes the first character of string and returns the shortened string.

       ::textutil::string::cap string
              Capitalizes the first character of string and returns the modified string.

       ::textutil::string::capEachWord string
              Capitalizes  the  first  character  of  word  of the string and returns the modified string. Words
              quoted with either backslash or dollar-sign are left untouched.

       ::textutil::string::uncap string
              The complementary operation to ::textutil::string::cap. Forces the first character  of  string  to
              lower case and returns the modified string.

       ::textutil::string::longestCommonPrefixList list

       ::textutil::string::longestCommonPrefix ?string...?
              Computes  the  longest  common  prefix for either the strings given to the command, or the strings
              specified in the single list, and returns it as the result of the command.

              If no strings were specified the result is the empty string.  If only one  string  was  specified,
              the string itself is returned, as it is its own longest common prefix.

BUGS, IDEAS, FEEDBACK

       This  document,  and  the package it describes, will undoubtedly contain bugs and other problems.  Please
       report such in the category  textutil  of  the  Tcllib  Trackers  [http://core.tcl.tk/tcllib/reportlist].
       Please also report any ideas for enhancements you may have for either package and/or documentation.

       When proposing code changes, please provide unified diffs, i.e the output of diff -u.

       Note  further  that  attachments  are strongly preferred over inlined patches. Attachments can be made by
       going to the Edit form of the ticket immediately after its creation, and then using the left-most  button
       in the secondary navigation bar.

SEE ALSO

       regexp(3tcl), split(3tcl), string(3tcl)

KEYWORDS

       capitalize, chop, common prefix, formatting, prefix, string, uncapitalize

CATEGORY

       Text processing