_guuid4 - Universal Unique Identifier Version 4 generieren (ab CRTE V21.0A50)

Definition	#include <bs2uuid4.h> int _guuid4(char *s, int len);
Beschreibung	_guuid4 generiert bei jedem Aufruf eine eindeutige 36-stellige Zeichenkette, die einen zufallsbasierten (Version 4) Universal Unique Identifier (UUID) gemäß ISO/IEC 9834-8 darstellt.
Parameter	char *s Zeiger auf die Ergebniszeichenkette s. Dieser Bereich muss lang genug sein, um len Zeichen aufzunehmen. int len len muss 36 oder 37 sein. Ist len 37, so wird die Ergebniszeichenkette mit einem Nullbyte abgeschlossen.
Returnwert	Ganzzahliger Wert vom Typ int
	0	bei Erfolg.
	-1	wenn len einen anderen Wert als 36 bzw. 37 hat. errno wird auf EINVAL gesetzt, um den Fehler anzuzeigen.  Der Speicherbereich, auf den s zeigt, bleibt im Fehlerfall unverändert.
Hinweise	In bs2uuid4.h ist UUID4_LEN als 37 definiert. Die Länge 36 wird unterstützt, um den direkten Aufruf der Funktion aus COBOL-Programmen zu vereinfachen.
Beispiel 1	Aufruf der Funktion aus einem C-Programm: #include <bs2uuid.h> ... char buf[UUID4_LEN]; if (_guuid4(buf, UUID4_LEN) == UUID4_ESUCCESS) { ... }
Beispiel 2	Aufruf der Funktion aus einem COBOL-Programm: >>SOURCE FREE >>IMP LISTING-OPTIONS MERGE-DIAGNOSTICS PROGRAM-ID. TSTUUID4. ENVIRONMENT DIVISION. CONFIGURATION SECTION. SPECIAL-NAMES. TERMINAL IS ttt. DATA DIVISION. WORKING-STORAGE SECTION. 01 uuid4 PIC X(36) VALUE ALL "X". 01 uuid-len PIC S9(5) COMP-5 VALUE 36. PROCEDURE DIVISION. PARA1. CALL "_guuid4" USING uuid4 BY VALUE uuid-len. DISPLAY uuid4 UPON ttt. GOBACK.