Navigation:  Klassen > bArrayServer >

bArrayServer:CopySDF()

Diese Seite drucken    Vorherige SeiteZurück zum Anfang des KapitelsNächste Seite

Zweck

Kopiert Datensätze in eine Textdatei. Alle Datensätze haben eine feste Länge.

Klasse

bArrayServer

Typ

Methode

Syntax

<oArrayServer>:CopySDF(

<oFSTarget> | <cTarget>,

[<aiField> | <acField> | <asymField> | <aoDFField>],

[<uForCondition>],

[<uWhileCondition>],

[<uScope>]

) Æ lSuccess

Argumente

<oFSTarget>Ein Dateipfad als FileSpec. Zu diesem Dateipfad wird die SDF Datei erzeugt. Eine vorhandene Datei wird überschrieben.
Datentyp:FileSpec

 

<cTarget>Ein Dateipfad als String. Zu diesem Dateipfad wird die SDF Datei erzeugt. Eine vorhandene Datei wird überschrieben.
Datentyp:String

 

<aiField>Ein Array mit Feldpositionen. Die Werte dieser Felder werden in die SDF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet.
Datentyp:Array

 

<acField>Ein Array mit Feldnamen als String. Die Werte dieser Felder werden in die SDF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet.
Datentyp:Array

 

<asymField>Ein Array mit Feldnamen als Symbol. Die Werte dieser Felder werden in die SDF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet.
Datentyp:Array

 

<aoDFField>Ein Array mit Feldern als DataField. Die Werte dieser Felder werden in die SDF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet.
Datentyp:Array

 

<uForCondition>Eine Bedingung, die für jeden Datensatz innerhalb des Scopes ausgewertet wird. Es werden nur Datensätze in die Textdatei kopiert, bei denen die Auswertung der Bedingung den Wert TRUE ergibt.
Datentyp:String | Codeblock | _Codeblock

 

<uWhileCondition>Eine Bedingung, die für jeden Datensatz innerhalb des Scopes ausgewertet wird. Sobald die Bedingung den Wert FALSE ergibt, werden keine weiteren Datensätze kopiert.
Datentyp:String | Codeblock | _Codeblock

 

<uScope>Definiert den Bereich der Datensätze, die beim Kopieren berücksichtigt werden sollen. Es werden die folgenden Werte unterstützt:

 

Wert

Beschreibung

DBSCOPEALL

Es werden alle Datensätze berücksichtigt.

DBSCOPEREST

Es werden alle Datensätze ab dem aktuellen Datensatz berücksichtigt.

<iRecords>

Anzahl der Datensätze, die ab dem aktuellen Datensatz berücksichtigt werden.

 

Datentyp:Logic | Int

Rückgabewert

lSuccessEin Logischer Wert der definiert, ob die Datensätze in die SDF Datei kopiert werden konnten.
TRUEDie Datensätze wurden kopiert.
FALSEDie Datensätze konnten nicht kopiert werden.
Datentyp:Logic

Beschreibung

bArrayServer:CopySDF() kopiert alle oder einzelne Datensätze aus dem ArrayServer in eine SDF Datei. Wenn die Datei bereits existiert, dann wird diese überschrieben. Der Verzeichnispfad auf die Datei muss bereits existieren. Er wird nicht automatisch erzeugt.

 

Die einzelnen Datensätze in der SDF Datei werden mit CRLF voneinander getrennt. Die Feldwerte innerhalb der Datensätze haben immer die gleiche Länge. Die Feldlänge wird durch die Feldstruktur im ArrayServer vorgegeben und kann mit der folgenden Methode ermittelt werden:

 

oArrayServer:FieldInfo(DBS_LEN, <uField>) -> <iFieldLen>

 

Wenn im Argument 2 keine spezielle Feldliste übergeben wird, dann werden alle Felder des ArrayServer in die SDF Datei kopiert.

 

Beim Erzeugen der Textdatei werden nur Felder berücksichtigt, die vom Datentyp "C", "D", "L", oder "N" sind. Felder mit anderen Datentypen werden ignoriert.

 

Hinweis!

Nach dem Kopieren ist der Datensatzzeiger unverändert.

Siehe auch

bArrayServer:CopyDB()

bArrayServer:CopyDelimited()

bArrayServer:CopyStructure()

bArrayServer:CopyToFile()

 


Page url: http://www.YOURSERVER.com/index.html?barrayserver_copysdf.htm