attachClobToFile()

Die Systemfunktion 'lobLib.attachClobToFile()' ordnet eine angegebene Datei einer CLOB-Variablen zu.

Ist die Datei bereits vorhanden ist, verwendet die Funktion diese vorhandene Datei. Andernfalls wird die Datei von der Funktion erstellt. Die Funktion gibt alle Hauptspeicher- bzw. Dateiressourcen, die der Variablen bisher zugeordnet waren, frei, und setzt die Länge der Datei auf null. Bei Erstellung der Zuordnung wird der aktuelle Wert der CLOB-Variablen von der Funktion nicht in die Datei geschrieben. Bei zukünftigen Änderungen an der Variablen (wie beispielsweise durch 'setClobFromString()' oder beim Lesen von Werten aus einer Datenbank in die Variable) wird der Wert der Variablen jedoch in die zugeordnete Datei geschrieben.

Um einen vorhandenen Wert der CLOB-Variablen in einer Datei zu speichern, müssen Sie die Systemfunktion 'updateClobToFile()' verwenden.

Syntax

  lobLib.attachClobToFile(
    CLOB-Variable CLOB inOut,
    Dateiname STRING in)
CLOB-Variable
Dies ist die CLOB-Variable. Wenn dieser Parameter einen Nullwert aufweist, löst EGL eine Ausnahmebedingung vom Typ 'NullValueException' aus.
Dateiname
Dies ist der Name der Datei. Dieser Name ist entweder ein vollständig qualifizierter Name oder ein relativer Name bezogen auf das Verzeichnis, von dem aus das Programm aufgerufen wird.

Feedback