table.getvarcol - Function

get a specific column (for variable arrays)

Synopsis
getvarcol(columnname, startrow, nrow, rowincr)

Description
Function getcol can only used if values in the column cells to get have the same shape. Function getvarcol addresses this limitation by returning the values as a record instead of an array. Each field in the record contains the value for a column cell. If the value is undefined (i.e. the cell does not contain a value), the unset value is put in the record. Each field name is the letter r followed by the row number. The length of the record is the number of rows to get.
Note that the function isvarcol tells if a column contains variable shaped arrays.

Arguments

columnname	in	Name of column
		Allowed:	String
startrow	in	First row to read (default 1)
		Allowed:	Int
nrow	in	Number of rows to read (default -1 means till the end)
		Allowed:	Int
rowincr	in	Increment in rows to read (default 1)
		Allowed:	Int

Returns
Record

Example

  t:=table("tcal",readonly=F)
# successful read/write open of table  tcal :  9 columns, 11 rows
  gain:=t.getvarcol("Gain")
  length(gain)
# 11

Next: table.getcolslice - Function Up: table - Tool Previous: table.getcol - Function Contents Index

	Package	utility
	Module	table
	Tool	table