f$PGKopie (f$PGCopy)

Kopieren aller Parameter einer Parametergruppe in eine andere. Die Parametergruppen können - müssen aber nicht - auf einer Parametergruppendefinition basieren. Die Parameterinhalte gleichen Namens werden kopiert. Alle anderen Parameter bleiben unberücksichtigt.

Bitte beachten: Der Name der Parametergruppe wird in der Regel als Zeichenketten-Konstante übergeben, also in Anführungszeichen eingeschlossen. Wird ein Zeichenkettenparameter übergeben - wie in der Syntaxbeschreibung - so wird der Wert des übergebenen Parameters als Parametergruppenname angesehen (sofern es sich um eine Zeichenkette handelt)

Syntax:	f$PGKopie( QuellPG, ZielPG[,Kopieroption,Anzahl,Parametername] )
	Argument	Typ	Bedeutung
	QuellPG	Zeichenkette	Name der Parametergruppe, die kopiert werden soll
	ZielPG	Zeichenkette	Name der Parametergruppe, auf die kopiert werden soll
	Kopieroption	Ganzzahlig	Dieses Argument ist optional. Es steuert beim Kopieren der Parametergruppe, was mit nicht belegten Parametern geschehen soll: 0 : Alle Parameter werden kopiert 1 : Parameter werden kopiert, wenn belegt oder LEER 2 : Parameter werden kopiert, wenn sie belegt sind
	Anzahl	Ganzzahlig	Dieses Argument ist optional. Mit diesem Argument steuert man die Anzahl der zu kopierenden Indizes bei einfach indizierten Parametergruppen. Wird als Wert 0 angegeben, werden alle Indizes der Parametergruppe kopiert, bzw. alle Indizes von 1 bis der angegebene Parameter unbelegt ist. Wird ein Wert != 0 angegeben, so werden die Indizes von 1 bis Anzahl der Parametergruppe kopiert. Wird das Argument nicht angegeben, wird nur ein Index kopiert.
	Parametername	Zeichenkette	Dieses Argument ist optional. Mit diesem Argument steuert man das Ende des Kopiervorgangs. Wenn in der Quellparametergruppe der Wert des angegebenen Parameters unbelegt ist, wird der Kopiervorgang beendet. Wenn dieses Argument angegeben wird, muss es ein gültiger Parameter der Quellparametergruppe sein.
Ergebnis:	-
Beispiel:	f$PGKopie( 'Motor', 'Teil' ) → Die Parametergruppe "Motor" wird auf "Teil" kopiert. f$PGKopie( 'Motor', 'Teil',2 ) → Die Parametergruppe "Motor" wird auf "Teil" kopiert. Nur belegte Parameter werden berücksichtigt. f$PGKopie( 'Motoren', 'Teile',0,0 ) → Alle Indizes der indizierten Parametergruppe "Motoren" werden auf die ebenfalls indizierte Parametergruppe Teile kopiert f$PGKopie( 'Motoren[i]', 'Teile[i]' ) → Der Index i der indizierten Parametergruppe "Motoren" wird auf der ebenfalls indizierten Parametergruppe"Teile" auf den Index i kopiert. f$PGKopie( 'Motoren', 'Teile',0,0,'MaterialNr' ) → Alle Indizes der indizierten Parametergruppe "Motoren" werden auf die ebenfalls indizierte Parametergruppe"Teile" kopiert bis der Parameter MaterialNr der Parametergruppe "Motoren" LEER oder UNDEF ist.