f$PGArrayCopy (f$PGFeldKopie)

Copy multiple lines of an indexed parameter group to another. The parameter groups can, but do not have to, be based on the same parameter group definition. Parameter content with the same name is copied. All other parameters are ignored. The destination parameter group is automatically enlarged when required. This is however only possible when the parameter group is 1-dimension and the parameters contained within are not indexed.

All lines which meet the entered criteria are copied. All entered criteria must be met for the data line to be copied. If the criteria parameter group is empty, or an empty string is entered, all lines are copied. The criteria are entered as an indexed parameter group with the following parameters:

Name

Name of the parameter in the source parameter group to be checked. If a parameter is entered that does not exist, no lines are copied.

Comparison

Comparison operators.

The following operators are possible with numeric values:

=, !=, <, <=, >,>=

The following operators are possible with strings:

=, !=, starts with, contains, ends with or beginnt mit, enthält, endet mit

Value

Comparison value

The destination parameter group is not emptied before copying. You can also add lines to an existing parameter group with multiple copies.

Please note: the name of the parameter groups is usually entered in string constants, i.e. in quotation marks.

Syntax:	Status = f$PGArrayCopy ( SourcePG , DestPGName , Destindex , CriteriaPGName )
	Argument	Type	Meaning
	SourcePG	String	Name of the parameter group to be copied
	DestPG	String	Name of the parameter group to be copied to
	Destindex	Integer	Start index in the destination parameter group
	CriteriaPGName	String	Name of the parameter group with the copying criteria
Result:	> 0	Number of lines copied
	0	Nothing was copied
	-1	The source parameter group does not exist
	-2	The destination parameter group does not exist
	-3	The destination parameter group cannot be enlarged.
Example:	Sum = f$PGArrayCopy ( 'Article' , 'Articles' , Start , 'Comparison' )