updf_destroy_element

updf_destroy_element löscht einen Stream oder Storage in einem Storage.

ret = updf_destroy_element(stg, name)

Returnwert

ret ist TRUE (1) oder ein Error-Objekt, falls ein Fehler aufgetreten ist (siehe error_create).

Parameter

stg

stg ist ein Storage-Objekt (siehe updf_create_file, updf_open_file, updf_create_storage).

name

name ist der Name des Streams oder Storages.

Kommentar

Falls name ein Storage ist, werden auch rekursiv alle Elemente (Streams und Storages) gelöscht die er enthält.

Beispiel

def test_updf_destroy_element()
{
    ssFile = GetTempPath() + "test.updf";

    stg = updf_create_file(ssFile);

    f = updf_create_stream(stg, "test1");
    fwrite_int8(f, 123);
    updf_file_close(f);

    f = updf_create_stream(stg, "test2");
    fwrite_int8(f, 124);
    updf_file_close(f);

    updf_close_storage(stg);


    stg = updf_open_file(ssFile);
    updf_destroy_element(stg, "test1");
    updf_close_storage(stg);

    stg = updf_open_file(ssFile);
    f = updf_open_stream(stg, "test1");
    if (type(f) != "error") {
        error();
    }
    f = updf_open_stream(stg, "test2");
    if (type(f) == "error") {
        error();
    }
    updf_file_close(f);

    updf_close_storage(stg);
}

test_updf_destroy_element();

History

Version	Beschreibung
5.6.0	Neu

Siehe auch

Überblick UPDF-Dateien, updf_rename_element

_id-1126673