updf_get_free_pages¶
updf_get_free_pages liefert die Anzahl an freien Seiten einer UPDF-Datei.
- nPages = updf_get_free_pages(stg)
Returnwert
nPages ist die Anzahl an freien Seiten.
Parameter
- stg
stg ist ein Storage-Objekt (siehe updf_create_file, updf_open_file, updf_create_storage).
Kommentar
Eine UPDF-Datei besteht aus Seiten der Größe 1024 Bytes. Wenn Elemente gelöscht
werden, entstehen leere Seiten, die bei der Erzeugung von Elementen wieder
verwendet werden. Falls die Datei mit dem UPDF_REPACKING-Flag erzeugt wurde,
werden die freien Seiten beim Schließen der Datei entfernt, so dass sich die
Datei verkürzt. Dies führt jedoch zu Performance-Einbußen. Im Allgemeinen ist es
deshalb besser das UPDF_REPACKING-Flag nicht zu verwenden, sondern falls sehr
viele freie Seiten vorhanden sind, die Datei zu packen indem eine neue UPDF-Datei
erzeugt wird und mit updf_copy_to die Streams und Storages in die neue
Datei kopiert werden.
History
Version |
Beschreibung |
|---|---|
R2013 (5.50) |
Neu. |
Siehe auch
id-1760231