updf_rename_element

updf_rename_element benennt einen Stream oder Storage um.

ret = updf_rename_element(stg, oldname, newname)

Returnwert

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

Parameter

stg

stg ist der Storage in dem sich der Storage oder Stream oldname befindet.

oldname

oldname ist der Name des Streams oder Storages.

newname

name ist der Name des Storages. Siehe Gültige Namen in Storages, Streams und Properties.

Beispiel

def test_updf_rename_element()
{
    ssPath = GetTempPath();

    stg = updf_create_file(ssPath + "test-rename.updf");
    f = updf_create_stream(stg, "test");
    fwrite_int8(f, 123);

    ret = updf_rename_element(stg, "test", "test-stream");
    if (type(ret) == "error") {
        error();
    }
    updf_file_close(f);

    ret = updf_rename_element(stg, "test-stream", "test-stream-2");
    if (type(ret) == "error") {
        error();
    }

    updf_close_storage(stg);

    stg = updf_open_file(ssPath + "test-rename.updf");
    f = updf_open_stream(stg, "test-stream-2");
    i8 = fread_int8(f, 1);
    if (i8 != 123) {
        error();
    }
    updf_file_close(f);
    updf_close_storage(stg);
}

test_updf_rename_element()

History

Version	Beschreibung
5.6.0	Neu

Siehe auch

Überblick UPDF-Dateien, updf_destroy_element

_id-1289254