table.getcol - Function

get a specific column

Synopsis
getcol(columnname, startrow, nrow, rowincr)

Description
The entire column (or part of it) is returned. Warning: it might be big! The functions can only be used if all arrays in the column have the same shape. That is guaranteed for columns containing scalars or fixed shaped arrays. For columns containing variable shaped arrays it only succeeds if all those arrays happen to have the same shape.
Note that function getvarcol can be used to get a column of arbitrary shaped arrays, which also handles empty cells correctly. Function isvarcol tells if a column contains variable shaped arrays. shaped

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
Array

Example

  t:=table("tcal",readonly=F)
# successful read/write open of table  tcal :  9 columns, 11 rows
  gain:=t.getcol("Gain")
  gain::shape
# [2 2 28 1 11]

Next: table.getvarcol - Function Up: table - Tool Previous: table.getcellslice - Function Contents Index

	Package	utility
	Module	table
	Tool	table