table.copyrows - Function

copy rows from this table to another

Synopsis
copyrows(outtable, startrowin, startrowout, nrow)

Description
Copy rows from this table to another. By default all rows of this table are appended to the output table. It is possible though to control which rows are copied.
Rows are added to the output table as needed. Because no rows can be added to a reference table, it is only possible to overwrite existing rows in such tables.

Only the data of columns existing in both tables will be copied. Thus by making a reference table consisting of a few columns, it is possible to copy those columns only.

Arguments

outtable	in	table object of output table
		Allowed:	String
startrowin	in	First row to take from input table
		Allowed:	Int
		Default:	1
startrowout	in	First row to write in output table
		Allowed:	Int
		Default:	-1 (=end)
nrow	in	Nr of rows to copy
		Allowed:	Int
		Default:	-1 (=all)

Returns
Bool

Example
This example appends rows to the table itself, thus doubles the number of rows.

  t:=table('test.ms',readonly=F)
  t.copyrows(t)

This example copies 10 rows of the selected subset of the MS to the beginning of the output MS.

  t:=table("3C273XC1.MS")
  tout:=table('test.ms',readonly=F)
  t1:=t.query('ANTENNA1==0')
  t1.copyrows(tout,nrow=10,startrowout=1)

Next: table.done - Function Up: table - Tool Previous: table.copy - Function Contents Index

	Package	utility
	Module	table
	Tool	table