updf_prop_enum

Mit updf_prop_enum kann über alle Properties eines Streams oder Storages iteriert werden.

propEnum = updf_prop_enum(props)

propEnum = updf_prop_enum(props, part_name)

Returnwert

propEnum-Objekt. Falls ein Fehler auftritt, wird ein Error-Objekt zurück gegeben (siehe error_create).

Parameter

props

props ist ein von updf_prop_open zurück gegebenes Objekt.

part_name

part_name sind die ersten Zeichen der gesuchten Properties. Es werden dann nur die Property-Namen geliefert mit mit diesen Zeichen anfangen.

Kommentar

updf_prop_enum erzeugt einen „Schnappschuss“ der Property-Namen des Streams oder Storages.

Beispiel

def test_updf_prop_enum()
{
    ssRoot = GetTempPath();
    ssFile = ssRoot + "test-prop-enum.updf";

    stg = updf_create_file(ssFile);

    props = updf_prop_open(stg);
    updf_prop_set_at(props, "a", updf_propval_new(1));
    updf_prop_set_at(props, "a1", updf_propval_new(2));
    updf_prop_set_at(props, "b", updf_propval_new(3));
    updf_prop_set_at(props, "abc", updf_propval_new(4));
    updf_prop_close(props);

    updf_close_storage(stg);

    stg = updf_open_file(ssFile);
    props = updf_prop_open(stg);

    enu = updf_prop_enum(props, "a");
    count = 0;
    while ((name = updf_prop_enum_next(enu)) != "") {
//        print name;
        count = count + 1;
    }
    if (count != 3) {
        error();
    }
    updf_prop_enum_close(enu);
    updf_prop_close(props);

    updf_close_storage(stg);


    stg = updf_open_file(ssFile);
    props = updf_prop_open(stg);

    enu = updf_prop_enum(props);
    count = 0;
    while ((name = updf_prop_enum_next(enu)) != "") {
//        print name;
        count = count + 1;
    }
    if (count != 4) {
        error();
    }
    updf_prop_enum_close(enu);
    updf_prop_close(props);

    updf_close_storage(stg);

}

test_updf_prop_enum();

History

Version	Beschreibung
5.6.0	Neu.

Siehe auch

Überblick UPDF-Dateien, updf_prop_enum_next, updf_prop_enum_close

_id-374366