Class std.list
Tables as lists.
 Prototype Chain
table
 `-> Object
      `-> List
    Objects
    
    - 
    
    std.list.List
    
- 
    An Object derived List.
Functions
    Methods
    
    - 
    
    std.list.append (l, x)
    
- 
    Append an item to a list.
    Parameters:Returns:
           List
        new list with x appended
     Usage:longer = append (short, "last") 
- 
    
    std.list.compare (l, m)
    
- 
    Compare two lists element-by-element, from left-to-right.
    Parameters:Returns:
        -1 if l is less than m, 0 if they are the same, and 1
   if l is greater than m
     Usage:if a_list:compare (another_list) == 0 then print "same" end 
- 
    
    std.list.concat (l, ...)
    
- 
    Concatenate the elements from any number of lists.
    Parameters:
        - l
            List
         a list
        
- ...
         tuple of lists
        
 Returns:
           List
        new list with elements from arguments
     Usage:
  list.concat ({1, 2, 3}, {{4, 5}, 6, 7})
- 
    
    std.list.cons (l, x)
    
- 
    Prepend an item to a list.
    Parameters:Returns:
           List
        new list with x followed by elements of l
     Usage:
  list.cons ({1, 2, 3}, "x")
- 
    
    std.list.rep (l, n)
    
- 
    Repeat a list.
    Parameters:
        - l
            List
         a list
        
- n
            int
         number of times to repeat
        
 Returns:
           List
        n copies of l appended together
     Usage:
  list.rep ({1, 2, 3}, 3)
- 
    
    std.list.sub (l[, from=1[, to=#l]])
    
- 
    Return a sub-range of a list.
 (The equivalent of ??? on strings; negative list indices
 count from the end of the list.)
    Parameters:
        - l
            List
         a list
        
- from
            int
         start of range
         (default 1)
        
- to
            int
         end of range
         (default #l)
        
 Returns:
           List
        new list containing elements between from and to
   inclusive
     Usage:
  list.sub ({1, 2, 3, 4, 5, 6}, 3, 5)
- 
    
    std.list.tail (l)
    
- 
    Return a list with its first element removed.
    Parameters:Returns:
           List
        new list with all but the first element of l
     Usage:
  list.tail {{1, 2}, 3, {4, 5}, 6, 7}
Metamethods
    
    - 
    
    std.list:__add (l, e)
    
- 
    Append element to list.
    Parameters:
        - l
            List
         a list
        
- e
         element to append
        
 See also:Usage:list = list + "element" 
- 
    
    std.list:__concat (l, m)
    
- 
    Concatenate lists.
    Parameters:
        - l
            List
         a list
        
- m
            List or table
         another list, or table (hash part is ignored)
        
 See also:Usage:new = alist .. {"append", "these", "elements"}
- 
    
    std.list:__le (l, m)
    
- 
    List equality or order operator.
    Parameters:See also:Usage:min = list1 <= list2 and list1 or list2 
- 
    
    std.list:__lt (l, m)
    
- 
    List order operator.
    Parameters:See also:Usage:max = list1 > list2 and list1 or list2