f$PGFeldKopie (f$PGArrayCopy)

Kopieren verschiedener Zeilen einer indizierten Parametergruppe in eine andere. Die Parametergruppen können - müssen aber nicht - auf derselben Parametergruppendefinition basieren. Die Parameterinhalte gleichen Namens werden kopiert. Alle anderen Parameter bleiben unberücksichtigt. Die Zielparametergruppe wird bei Bedarf automatisch vergrößert. Dies ist aber nur dann möglich, wenn die Parametergruppe einfach indiziert ist und auch die enthaltenen Parameter nicht indiziert sind.

Es werden alle Zeilen kopiert, die den angegebenen Kriterien entsprechen. Alle angegebenen Kriterien müssen erfüllt sein, damit die Datenzeile kopiert wird. Falls die Kriterienparametergruppe leer ist, oder ein Leerstring übergeben wird, werden alle Zeilen kopiert. Die Kriterien werden als indizierte Parametergruppe mit folgenden Parametern übergeben:

Name

Name des zu prüfenden Parameters der Quellparametergruppe.

Bei Angabe eines nicht existierenden Parameters wird keine Zeile kopiert.

Vergleich

Vergleichsoperator.

Folgende Operatoren sind bei Zahlenwerten möglich:

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

Folgende Operatoren sind bei Zeichenketten möglich:

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

Wert

Vergleichswert

Die Zielparametergruppe wird vor dem Kopiervorgang nicht geleert. Sie können mit unterschiedlichen Kopiervörgängen auch Zeilen an eine bestehende Parametergruppe anfügen.

Bitte beachten: Der Name der Parametergruppen wird in der Regel als Zeichenketten-Konstante übergeben, also in Anführungszeichen eingeschlossen.

Syntax:	Status = f$PGFeldkopie ( QuellPG , ZielPGName , Zielindex , KriterienPG )
	Argument	Typ	Bedeutung
	QuellPG	Zeichenkette	Name der Parametergruppe, die kopiert werden soll
	ZielPG	Zeichenkette	Name der Parametergruppe, auf die kopiert werden soll
	Zielindex	Ganzzahlig	Startindex in der Zielparametergruppe
	KriterienPG	Zeichenkette	Name der Parametergruppe mit den Kopierkriterien
Ergebnis:	> 0	Anzahl der kopierten Zeilen
	0	Es wurde nichts kopiert
	-1	Die Quellparametergruppe existiert nicht
	-2	Die Zielparametergruppe existiert nicht
	-3	Die Zielparametergruppe kann nicht vergrößert werden.
Beispiel:	Anz = f$PGFeldkopie ( 'Artikel' , 'Artikelz' , Start , 'Vergleich' )