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