uuid_is_nil, uuid_compare, or uuid_equal Subroutine

Purpose

Compares universally unique identifiers (UUIDs).

Libary

Standard C Library (libc.a)

Syntax

#include <uuid.h>

signed32 (uuid1, uuid2, status )
boolean32     uuid_equa (uuid1, uuid2, status)
boolean32     uuid_is_nil (uuid1, status)
uuid_p_t      uuid1;
uuid_p_t      uuid2;
unsigned32    status;

Description

The uuid_is_nil subroutine checks whether the binary UUID pointed to by uuid1 is a nil UUID. The uuid_compare subroutine compares two binary UUIDs. The uuid_equal subroutine checks if two binary UUIDs are equal. If either of the parameters is a NULL pointer, the other parameter will be compared against the nil UUID.

Parameters

Item Description
uuid1 Pointer identifying the first UUID to be compared
uuid2 Pointer identifying the second UUID to be compared
status Points to the location where the status of the operation is to be stored.

Return Values

The uuid_is_nil subroutine returns a 1 if the UUID passed is a nil UUID, otherwise it returns 0. The uuid_equal subroutine returns a 1 if both UUIDs are equal, otherwise it returns 0. The uuid_compare subroutine returns a -1 if the uuid1 is lexically before uuid2, returns 0 if both the uuid1 and uuid2 are equal, otherwise the uuid_compare subroutine returns a -1.