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

QueryFileName - Abfrage des Dateinamens

const char * CxiTreeFile :: QueryFileName () const
const char * cxiQueryFileName (CxiHandle self)

Liefert den Dateinamen eines CxiTreeFile

return:
Zeiger auf Namen der Datei, bei Fehler NULL

Diese Funktion liefert den Namen der Datei, der beim Konstruktor des Objekts angegeben wurde oder vom CXI-System generiert wurde.

ACHTUNG: Es wird direkt ein Zeiger auf den internen Verwaltungsbereich des CXI-Systems zurückgegeben. Dieser Zeiger ist bis zum nächsten Aufruf einer CxiTree-Funktion gültig. Der Bereich, auf den der Zeiger zeigt, darf unter keinen Umständen direkt verändert werden. Der zurückgegebene Zeiger darf NICHT direkt als Parameter in einem Aufruf einer CxiTree-Funktion verwendet werden. Geschieht dies doch, ist das Verhalten des Programms undefiniert.

Je nach Betriebssystem und Optionen kann das CXI-System den Dateinamen um einen absoluten Pfad erweitern. Ansonsten wird der Name exakt so zurückgegeben, wie er beim Konstruktor angegeben war.

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

Siehe auch:
CxiTreeFile(...)
QueryFileOptions - Abfrage der Optionen

Beispiel:

#include "cxib.h"
#include <stdio.h>

int main (void)
{
  CxiTreeFile in ("GROSS.CXI", 0, cxiOptReadOnly | cxiOptVirtual);
  printf ("File name = \"%s\", options = %04X\n",
          in.QueryFileName(),
          in.QueryFileOptions());
  return 0;
}

Mögliche Ausgabe des Beispiels:
File name = "C:\TEST\GROSS.CXI", options = 0012