Chart of existing list functionality

Difference between version 14 and 15 - Previous - Next
Purpose: Comparison of available extensions with respect to the provided llist functionality.

Caveat: This chart has (in 2008) been left unattended for several years, so some information may be out of date, and newer packages may be missing.
----
Entries are prefixed with a shorthand for the extension containing the command. Similar or equal functionality is grouped together wherever possible.

   * AQ   = [aqtools]     /''done''/
   * AT   = [AsserTcl]    /''done''/
   * EL   = [ExtraL]      /''done''/
   * JT   = jultaf      /''done''/
   * Opt  = Opt package in Tcl  --- waiting for inclusion
   * PB   = Pool_Base   /''done''/
   * Tcl  = Tcl standard distribution
   * TclX = [TclX]        /''done''/
   * s::l = [struct::list]

[Lars H], 2008-09-10: The (EL) command names listed below doesn't match those of the ExtraL documentation [http://extral.sourceforge.net/doc/listcommands.html], e.g. '''oneof''' below is called '''inlist''' in the docs, '''lunion''' below is called '''list_union''' in the docs, … Does anyone know how that may come?

----
   (EL):   '''oneof''' ''element list'' 
   (TclX):   '''lcontain''' ''list element''
   (Tcl 8.5):   '''tcl::mathop::in''' ''element list'' or '''[expr] {''' ''element'' '''in''' ''list'' '''}'''
        Determine if the element is a list element of list. If the
        element is contained in the list, 1 is returned, otherwise,
        0 is returned. 

(EL)    lunion list list ... 
        returns the union of the lists 

(TclX)  union lista listb
        Procedure to return the logical union of the two specified lists.
        Any duplicate elements are removed.

(EL)    lcommon list list ... 
        returns the common elements of the lists.

(TclX)  intersect lista listb
        Procedure to return the logical intersection of two lists.
        The returned list will be sorted. 

(EL)    leor list1 list2 
        returns the elements that are not shared between both lists 

(TclX)  intersect3 lista listb
        Procedure to intersects two lists, returning a list containing
        three lists: The first list returned is everything in lista that
        wasn't in listb. The second list contains the intersection of
        the two lists, and the third list contains all the elements
        that were in listb but weren't in lista. The returned lists
        will be sorted. 

(TclX)  lempty list
        Determine if the specified list is empty. If empty, 1 is
        returned, otherwise, 0 is returned. This command is an
        alternative to comparing a list to an empty string, however
        it checks for a string of all whitespaces, which is an empty
        list. 
----
(JT)    Juf::Sequence::assign LIST ?NAME ...?
        Sets value of the variables specified by the NAME arguments to
        that of the existing elements of LIST. Returns remaining list
        elements. If the number of variables exceeds the list length,
        the remaining variables will be removed.

   (PB):   '''::pool::list::assign''' ''varList list''
   (Tcl 8.x):   '''[foreach]''' ''varList list'' '''break'''
        By Brent Welch. Assigns a set of variables from a list of values.
        If there are more values than variables, they are ignored. If
        there are fewer values than variables, the variables get the empty
        string. 

   (TclX, Tcl8.5):   '''[lassign]''' ''list var'' ?''var'' ...?
        Assign successive elements of a list to specified variables.
        If there are more variable names than fields, the remaining
        variables are set to the empty string. If there are more
        elements than variables, a list of the unassigned elements
        is returned. 

        For example, 

                lassign {dave 100 200 {Dave Foo}} name uid gid longName 

        Assigns name to ``dave'', uid to ``100'', gid to ``200'', and
        longName to ``Dave Foo''. 
----
   (EL):   '''lfind''' ''mode list pattern''
   (TclX):   '''lmatch''' ?''mode''? ''list pattern''
        Search the elements of list, returning a list of all elements
        matching pattern. If none match, an empty list is returned. 

        The mode argument indicates how the elements of the list are
        to be matched against pattern and it must have one of the
        following values: 

        -exact  The list element must contain exactly the same string
                as pattern. 

        -glob   Pattern is a glob-style pattern which is matched against
                each list element using the same rules as the string
                match command. 

        -regexp Pattern is treated as a regular expression and matched
                against each list element using the same rules as the
                regexp command. 

        If mode is omitted then it defaults to -glob. 

   (JT):   '''Juf::Sequence::match''' ''PATTERN LIST''
        Returns a new list with all elements of LIST matching PATTERN
        as with string match. == glob '''!'''

   (PB):   '''::pool::list::match''' ''list pattern''
   (Tcl 8.5):   '''lsearch -all -inline''' ''list pattern''
        All words not contained in list pattern are removed from list.
        In set-notation: result = intersect (list, pattern). This is
        not completely true, duplicate entries in 'list' remain in the
        result, given that they appear at all. 

   (PB):   '''::pool::list::filter''' ''list pattern''
   (Tcl 8.5):   '''lsearch -all -inline -not''' ''list pattern''
        All words contained in the list pattern are removed from list.
        In set-notation: result = list - pattern. Returns the set
        difference of list and pattern. '''Negative match'''.

(EL)    llremove ?-sorted? list1 list2 ?var?
        returns a list with all items in list1 that are not in list2. with
        the -sorted option the command will usually be a lot faster, but
        both given lists must be sorted with lsort; The optional $var give
        the name of a variable in which the removed items will be stored. 

----
(EL)    lremdup ?-sorted? list ?var?
        returns a list in which all duplactes are removed. with the
        -sorted option the command will usually be a lot faster,
        but $list must be sorted with lsort; The optional $var gives
        the name of a variable in which the removed items will be stored. 

(TclX)  lrmdups list
        Procedure to remove duplicate elements from a list. The returned
        list will be sorted. 

(PB)    ::pool::list::uniq list
        Removes duplicate entries from list. Returns the modified list. 

----
(EL)    laddnew listName ?item? ... 
        adds the items to the list if not already there 

(JT)    Juf::Sequence::append ?OPTION ...? NAME ?VALUE ...?
        Works like the Tcl builtin lappend, but considers these options: 

        -nonempty       Append only non-empty values.
        --              Marks the end of the options. The argument
                        following this one will be treated as NAME
                        even if it starts with a -. 

(TclX)  lvarcat var string ?string...?
        This command treats each string argument as a list and concatenates
        them to the end of the contents of var, forming a a single list.
        The list is stored back into var and also returned as the result.
        if var does not exist, it is created. 
----
(PB)    ::pool::list::pop listVar
        Removes the last element of the list contained in variable listVar. 
        Returns the last element of the list, or {} in case of an empty list. 

(JT)    Juf::Sequence::pop NAME ?COUNT?
        Removes COUNT element from the end of the list stored in the
        variable NAME and returns the last element removed. COUNT
        defaults to 1. 

(EL)    lpop listName ?pos? 
        returns the last element from a list, thereby removing it from
        the list. If pos is given it will return the pos element of the
        list. 

(JT)    Juf::Sequence::shift NAME ?COUNT?
        Removes COUNT element from the list stored in the variable NAME
        and returns the last element removed. COUNT defaults to 1.

(EL)    lshift listName 
        returns the first element from a list, thereby removing it from
        the list. 

(PB)    ::pool::list::shift listVar
        The list stored in the variable listVar is shifted down by one. 
        Returns the first element of the list stored in listVar, or {}
        for an empty list. The latter is not a sure signal, as the list
        may contain empty elements. 

(PB)    ::pool::list::remove listVar position
        Removes the item at position from the list stored in variable
        listVar. 

(PB)    ::pool::list::exchange listVar position newItem
        Removes the item at position from the list stored in variable
        listVar and inserts newItem in its place. Returns the changed list. 

(TclX)  lvarpop var ?indexExpr? ?string?
        The lvarpop command pops (deletes) the element indexed by the
        expression indexExpr from the list contained in the variable var.
        If index is omitted, then 0 is assumed. If string, is specified,
        then the deleted element is replaced by string. The replaced or
        deleted element is returned. Thus ``lvarpop argv 0'' returns the
        first element of argv, setting argv to contain the remainder of the
        string. 

        If the expression indexExpr starts with the string end, then end
        is replaced with the index of the last element in the list. If the
        expression starts with len, then len is replaced with the length
        of the list. 
----
(PB)    ::pool::list::push listvar args
        The same as 'lappend', provided for symmetry only. 

(EL)    lpush listName ?item? ?position? 
        opposite of lpop. 

(EL)    lunshift listName ?item? 
        opposite of lshift: prepends ?item? to the list. 

   (PB):   '''::pool::list::prepend''' ''listVar newElement''
   (PB):   '''::pool::list::unshift''' ''listVar newElement''
        The list stored in the variable listVar is shifted up by one.
        newElement is inserted afterward into the now open head position. 

(TclX)  lvarpush var string ?indexExpr?
        The lvarpush command pushes (inserts) string as an element in the
        list contained in the variable var. The element is inserted before
        position indexExpr in the list. If index is omitted, then 0 is
        assumed. If var does not exists, it is created. 

        If the expression indexExpr starts with the string end, then end
        is replaced with the index of the last element in the list. If
        the expression starts with len, then len is replaced with the
        length of the list. Note the a value of end means insert the
        string before the last element. 
----
(PB)    ::pool::list::head list
        Returns the first element of list. 

(PB)    ::pool::list::last list
        Returns the last element of list. 

(PB)    ::pool::list::prev list
        Returns everything before the last element of list. 

(PB)    ::pool::list::tail list
        Returns everything behind the first element of list. 

----
(EL)    remove listName ?item? ... 
        removes the items from the list 

(PB)    ::pool::list::delete listVar value
        By Brent Welch. Deletes an item from the list stored in
        listVar, by value. Returns 1 if the item was present, else 0. 

----
(EL)    lsub list ?-exclude? index_list
        create a sublist from a set of indices. When -exclude is specified,
        the elements of which the indexes are not in the list will be given. 
        eg.:

        % lsub {Ape Ball Field {Antwerp city} Egg} {0 3}
        Ape {Antwerp city}
        % lsub {Ape Ball Field {Antwerp city} Egg} -exclude {0 3}
        Ball Field Egg

(PB)    ::pool::list::select list indices
        Idea from a thread in c.l.t.
        General permutation / selection of list elements. Takes the elements
        of list whose indices were given to the command and returns a new list
        containing them, in the specified order. 

----

(EL)    lcor 
        gives the positions of the elements in list in the reference list.
        If an element is not found in the reference list, it returns -1.
        Elements are matched only once. eg.:

        % lcor {a b c d e f} {d b}
        3 1
        % lcor {a b c d e f} {b d d}
        1 3 -1

(EL)    lmerge ?list1? ?list2? ??spacing?? 
        merges two lists into one eg.:

        % lmerge {a b c} {1 2 3}
        a 1 b 2 c 3
        % lmerge {a b c d} {1 2} 2
        a b 1 c d 2

(EL)    lunmerge ?list? ?spacing? ?var?
        unmerges items from a list to the result; the remaining items are
        stored in the given variable ?var? eg.:

        % lunmerge {a 1 b 2 c 3}
        a b c
        % lunmerge {a b 1 c d 2} 2 var
        a b c d
        % set var
        1 2

(EL)    lset listName ?item? ?indexlist? 
        sets all elements of the list at the given indices to value ?item? 

(EL)    larrayset array varlist valuelist 
        sets the values of valuelist to the respective elements in varlist
        for the given array.

(EL)    lregsub ?switches? exp list subSpec 
        does a regsub for each element in the list, and returns the resulting
        list. eg.:

        % lregsub {c$} {afdsg asdc sfgh {dfgh shgfc} dfhg} {!}
        afdsg asd! sfgh {dfgh shgf!} dfhg
        % lregsub {^([^.]+)\.([^.]+)$} {start.sh help.ps h.sh} {\2 \1}
        {sh start} {ps help} {sh h}

(PB)    ::pool::list::reverse list
        Returns the reversed list. 

(PB)    ::pool::list::projection list column
        Treats list as list of lists and extracts the column'th element of
        each list item. If list is seen as matrix, then the procedure
        returns the data of the specified column. 

(PB)    ::pool::list::apply cmd list
        Applies cmd to all entries of list and concatenates the
        individual results into a single list. The cmd must accept exactly
        one argument, which will be the current element.

(PB)    ::pool::list::lengthOfLongestEntry (list)
        Determines the length of the longest entry contained in the list.

(AT)    lall item_list list expr
        List universal quantifier: evaluates expr for all items or item sequences,
        and returns 1 if the expresson is true over the whole list, and 0 otherwise

(AT)    lexit item_list list expr
        List existential quantifier: evaluates expr for all items or item sequences,
        and returns 1 if the expresson is true for any item in the list, and 0 otherwise

(AQ)    j:longest_match
        find the longest common initial string in a list
----
-- AK


<<categories>> Survey