CXI-Basis-Programmierreferenz / Version 2 / Tools / Eindeutige Kennungen /

QueryUniqueName - Eindeutiger Name

static char * CXIB :: QueryUniqueName (char *buffer)
char * cxiQueryUniqueName (char *buffer)

Abfrage eines eindeutigen Namens

buffer:
Puffer, der den Namen aufnehmen soll, er muss Platz für die 8 Zeichen des Namens plus ein Nullbyte bieten

return:
buffer

Diese Funktion liefert einen eindeutigen Namen, der aus dem Datum, der Uhrzeit und einem internen Zähler gebildet wird. Unter allen Systemen sind maximal 256 Aufrufe dieser Funktion pro Timer-Intervall (1/18 Sekunde bei DOS, kleiner bei anderen Systemen) erlaubt, ansonsten kann sich ein Name wiederholen.

Die Funktion generiert einen Namen, der immer aus exakt acht Zeichen besteht. Eingesetzt werden Ziffern und Kleinbuchstaben.

Der Zähler hat eine Umlaufzeit von circa fünf Jahren (DOS, Windows, OS/2). Danach können sich theoretisch Werte wiederholen.

Diese Funktion kann benutzt werden, um eindeutige Dateinamen zu kreieren.

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

Siehe auch:
QueryUniqueNumber - Eindeutige Zahl
QueryThreadName - Eindeutige Kennung des Threads