Getting Started Documentation Glish Learn More Programming Contact Us
Version 1.9 Build 1556
News FAQ
Search Home


next up previous contents index
Next: tableiterator.table - Function Up: tableiterator - Tool Previous: tableiterator - Tool


tableiterator - Constructor



Package utility
Module table
Tool tableiterator


Construct a tableiterator


Synopsis
tableiterator(tab, columns, order, sort)


Description
Construct an iterator for the given table. Each step in the iteration returns a subtable for which the values of the given columns are equal. By default the table will be sorted before the iteration is started to achieve that all equal values are grouped together.
The optional order argument can be given to define how the table has to be sorted. 'a' is ascending, 'd' is descending, other is don't care (which comes to ascending). Instead of a single letter any word can be used starting with a or d (e.g. asc).
The optional sort argument can be given to define if the table has to be sorted. F means no sorting. The default T means sorting. The default sort algorithm used is heapsort. By giving the sort argument a string value, it can also be used to specify another sort algorithm. 'n' is no sort, 'q' is quicksort, 'i' is insertion sort, other is heapsort. A full word can also be used.



Arguments

tab in table to be iterated
    Allowed: table tool
columns in Array of column names
    Allowed: Vector of Strings
order in Order when sorting the table
    Allowed: String
    Default: ''
sort in Sort the table first?
    Allowed: Bool,String
    Default: T




next up previous contents index
Next: tableiterator.table - Function Up: tableiterator - Tool Previous: tableiterator - Tool   Contents   Index
Please send questions or comments about AIPS++ to aips2-request@nrao.edu.
Copyright © 1995-2000 Associated Universities Inc., Washington, D.C.

Return to AIPS++ Home Page
2006-10-15