Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

componentlist.concatenate - Function

	Package	synthesis
	Module	componentmodels
	Tool	componentlist

Append components from another componentlist.

Synopsis
concatenate(list, which, log)

Description

The concatenate function copies the specified component(s), from the specified to list, to the end of the current list. The components are specified by numbering them from one to the length of the list. You cannot append components to a list that has been opened read only but the list you are copying from may be readonly.

You use a vector of indices to copy a number of components at once. By default all components are copied.

Arguments

list		list to copy from
		Allowed:	a componentlist tool
		Default:	no default
which		which components to copy
		Allowed:	a integer or integer vector
		Default:	unset
log		Send a message to the logger
		Allowed:	Boolean
		Default:	T

Returns
nothing

Example

      include 'componentlist.g'
      cl1 := componentlist('crux.cl');
      cl2 := emptycomponentlist();
      cl2.concatenate(cl1, [1,3]);
      cl1.done()
      cl2.rename('crux-copy.cl');
      cl2.done()

This example reads a componentlist from an AIPS++ table and copies the first and third component to another a componentlist that was initially empty. These components are then saved to the table called crux-copy.cl.