updf_create_file

updf_create_file erzeugt eine neue UPDF-Datei.

stg = updf_create_file(name)
stg = updf_create_file(name, mode)

Returnwert

stg ist ein Storage-Pointer oder ein Error-Objekt, falls ein Fehler aufgetreten ist (siehe error_create).

Parameter

name

name ist der Name der UPDF-Datei. Wird :memory: für den Dateinamen angegeben, wird die Datei im Speicher erzeugt.

mode

mode ist einer der folgenden Werte:

UPDF_FAIL_IF_EXIST Falls Datei existiert, wird die Datei nicht überschrieben, sondern ein Fehlerwert zurück gegeben.
UPDF_REPACKING Falls Storages, Streams oder Attribute gelöscht werden, wird die Datei verkürzt. Falls dieses Flag nicht angegeben wird, wird der Speicherplatz für neue Objekte verwendet.
UPDF_ZLIB_COMPRESSION Verbesserte Kompession mit etwas schlechterer Performance.
UPDF_LZ4_COMPRESSION Sehr schnelle Kompression, siehe https://code.google.com/p/lz4/.

Beispiel

def test_updf_create_file()
{
    ssFile = GetTempPath() + "test.updf";
    stg = updf_create_file(ssFile);
    if (type(stg) != "xStg") {
        error();
    }

    f = updf_create_stream(stg, " test 1");
    if (type(f) != "xFile") {
        error();
    }
    fprintf(f, "%s", "This is a text written in Stream 'test 1'.");
    fclose(f);

    f = updf_create_stream(stg, "test 2");
    if (type(f) != "xFile") {
        error();
    }
    fprintf(f, "%s", "This is a text written in Stream 'test 2'.");
    fclose(f);

    updf_close_storage(stg);
}

test_updf_create_file();

History

Version Beschreibung
R2013.9 UPDF_LZ4_COMPRESSION.
R2013.5 :memory: für name dokumentiert.
5.6.0 Neu

id-1891360