CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Ableitung CxiTreeFile /

EnableFileCache - Aktivierung des Cache

CxiError CxiTreeFile :: EnableFileCache (int nsize = 2) const
CxiError cxiEnableFileCache (CxiHandle self, int nsize, CxiLong bsize)

Aktiviert die Zwischenspeicherung von Knoten

nsize:
Anzahl der Knoten, die der Zwischenspeicher (Cache) maximal aufnehmen kann; 0 deaktiviert den Cache, Werte von 2 bis 255 aktivieren die Zwischenspeicherung; andere Werte sind ungültig.

return:
0 ok, sonst Fehler

Zur Steigerung der Verarbeitungsgeschwindigkeit kann der Klasse CxiTreeFile mit dieser Funktion ein Speicherbereich zur Verfügung gestellt werden, in dem bereits aus der Datei gelesene Knoten des CXI-Baums abgelegt werden. Wird ein solcher Knoten dann nochmals benötigt, kann er aus dem Speicher abgerufen werden, dadurch wird ein langwieriger Dateizugriff gespart.

Bei einem Baum mit vielen kleinen Knoten, in dem häufig das Sichtfenster gewechselt wird, ist die Auswirkung eines Cache auf die Geschwindigkeit besonders groß.

Die CxiTreeFile-Konstruktoren legen einen Standard-Cache an, dessen Größe systemabhängig ist. Soll keine oder eine erweiterte Zwischenspeicherung erfolgen, so muss anschließend diese Funktion aufgerufen werden.

Existiert beim Aufruf von EnableFileCache bereits ein Cache, so wird dieser zunächst freigegeben.

Der Cache kann mit DisableFileCache explizit freigegeben werden. Geschieht dies nicht, gibt der Destruktor den Bereich automatisch frei.

Wurde die Datei mit der Option "b" (cxiOptShadowBuffer) geöffnet (CxiTreeFile-Konstruktor) und der Inhalt der Datei vollständig gelesen, so ist ein zusätzlicher Cache mit dieser Funktion unnötig. Der Aufruf wird in diesem Fall ignoriert.

Wurde die Datei mit der Option "v" (cxiOptVirtual) geöffnet (CxiTreeFile-Konstruktor), so unterbindet das CXI-System eine Zwischenspeicherung für diese Datei, um auch bei Parallelzugriffen die Datenkonsistenz sicherstellen zu können. Der Aufruf von EnableFileCache wird in diesem Fall ignoriert.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
CxiTreeFile(...)
DisableFileCache - Deaktivierung des Cache