


textutil::sText(and string utilities, macro protextutil::split(n)


______________________________________________________________________________

NAME
       textutil::split - Procedures to split texts

SYNOPSIS
       package require Tcl  8.2

       package require textutil::split  ?0.7?

       ::textutil::split::splitn string ?len?

       ::textutil::split::splitx string ?regexp?

_________________________________________________________________

DESCRIPTION
       The  package  textutil::split  provides  commands that split strings by
       size and arbitrary regular expressions.

       The complete set of procedures is described below.

       ::textutil::split::splitn string ?len?
              This command splits the given string into chunks of len  charac-
              ters  and  returns  a list containing these chunks. The argument
              len defaults to 1 if none is specified. A negative length is not
              allowed  and will cause the command to throw an error. Providing
              an empty string as input  is  allowed,  the  command  will  then
              return  an  empty  list.  If  the length of the string is not an
              entire multiple of the chunk length, then the last chunk in  the
              generated list will be shorter than len.

       ::textutil::split::splitx string ?regexp?
              This  command splits the string and return a list. The string is
              split according to the regular expression regexp  instead  of  a
              simple  list  of  chars.  Note that if you parentheses are added
              into the regexp, the parentheses part of separator will be added
              into  the  result  list  as additional element. If the string is
              empty the result is the empty list, like for split. If regexp is
              empty  the  string is split at every character, like split does.
              The regular expression regexp defaults to "[\\t \\r\\n]+".


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       SF       Trackers       [http://source-
       forge.net/tracker/?group_id=12883].   Please  also report any ideas for
       enhancements you may have for either package and/or documentation.

SEE ALSO
       regexp(n), split(n), string(n)





textutil                       0.7                              1





textutil::sText(and string utilities, macro protextutil::split(n)


KEYWORDS
       regular expression, split, string

CATEGORY
       Text processing




















































textutil                       0.7                              2


