uuid-generic.cpp revision c98fb3e16fcd571a790eab772c0c66173d225205
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/* $Id$ */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/** @file
c97989161fbe75bc14cea477a5443bbf474dd3advboxsync * innotek Portable Runtime - UUID, Generic.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/*
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * Copyright (C) 2006-2007 innotek GmbH
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync *
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * available from http://www.virtualbox.org. This file is free software;
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * you can redistribute it and/or modify it under the terms of the GNU
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * General Public License as published by the Free Software Foundation,
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * in version 2 as it comes in the "COPYING" file of the VirtualBox OSE
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * distribution. VirtualBox OSE is distributed in the hope that it will
c98fb3e16fcd571a790eab772c0c66173d225205vboxsync * be useful, but WITHOUT ANY WARRANTY of any kind.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/*******************************************************************************
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync* Header Files *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync*******************************************************************************/
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#include <iprt/uuid.h>
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#include <iprt/assert.h>
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#include <iprt/err.h>
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#include <iprt/time.h>
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#include <iprt/asm.h>
cbdacdaddb60c7977fc6c3073141b0c756d46824vboxsync#include <iprt/rand.h>
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/* WARNING: This implementation ASSUMES little endian. */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/**
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Generates a new UUID value.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @returns iprt status code.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid Where to store generated uuid.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
49d36b55bcf206ced156a303dab448a75fac001bvboxsyncRTDECL(int) RTUuidCreate(PRTUUID pUuid)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync{
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /* validate input. */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pUuid, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
cbdacdaddb60c7977fc6c3073141b0c756d46824vboxsync RTRandBytes(pUuid, sizeof(*pUuid));
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.u16ClockSeq = (pUuid->Gen.u16ClockSeq & 0x3fff) | 0x8000;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.u16TimeHiAndVersion = (pUuid->Gen.u16TimeHiAndVersion & 0x0fff) | 0x4000;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return VINF_SUCCESS;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync}
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/**
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Makes a null UUID value.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @returns iprt status code.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid Where to store generated null uuid.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
49d36b55bcf206ced156a303dab448a75fac001bvboxsyncRTDECL(int) RTUuidClear(PRTUUID pUuid)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync{
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pUuid, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->au64[0] = 0;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->au64[1] = 0;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return VINF_SUCCESS;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync}
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/**
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Checks if UUID is null.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @returns true if UUID is null.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid uuid to check.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
49d36b55bcf206ced156a303dab448a75fac001bvboxsyncRTDECL(int) RTUuidIsNull(PCRTUUID pUuid)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync{
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pUuid, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return !pUuid->au64[0]
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync && !pUuid->au64[1];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync}
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/**
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Compares two UUID values.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @returns 0 if eq, < 0 or > 0.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid1 First value to compare.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid2 Second value to compare.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
49d36b55bcf206ced156a303dab448a75fac001bvboxsyncRTDECL(int) RTUuidCompare(PCRTUUID pUuid1, PCRTUUID pUuid2)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync{
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /*
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Special cases.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1 == pUuid2)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return 0;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (!pUuid1)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return RTUuidIsNull(pUuid2) ? 0 : -1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (!pUuid2)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return RTUuidIsNull(pUuid1) ? 0 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /*
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Standard cases.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.u32TimeLow != pUuid2->Gen.u32TimeLow)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.u32TimeLow < pUuid2->Gen.u32TimeLow ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.u16TimeMid != pUuid2->Gen.u16TimeMid)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.u16TimeMid < pUuid2->Gen.u16TimeMid ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.u16TimeHiAndVersion != pUuid2->Gen.u16TimeHiAndVersion)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.u16TimeHiAndVersion < pUuid2->Gen.u16TimeHiAndVersion ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.u16ClockSeq != pUuid2->Gen.u16ClockSeq)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.u16ClockSeq < pUuid2->Gen.u16ClockSeq ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.au8Node[0] != pUuid2->Gen.au8Node[0])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.au8Node[0] < pUuid2->Gen.au8Node[0] ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.au8Node[1] != pUuid2->Gen.au8Node[1])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.au8Node[1] < pUuid2->Gen.au8Node[1] ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.au8Node[2] != pUuid2->Gen.au8Node[2])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.au8Node[2] < pUuid2->Gen.au8Node[2] ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.au8Node[3] != pUuid2->Gen.au8Node[3])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.au8Node[3] < pUuid2->Gen.au8Node[3] ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.au8Node[4] != pUuid2->Gen.au8Node[4])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.au8Node[4] < pUuid2->Gen.au8Node[4] ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync if (pUuid1->Gen.au8Node[5] != pUuid2->Gen.au8Node[5])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return pUuid1->Gen.au8Node[5] < pUuid2->Gen.au8Node[5] ? -1 : 1;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return 0;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync}
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/**
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Converts binary UUID to its string representation.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @returns iprt status code.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid Uuid to convert.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pszString Where to store result string.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param cchString pszString buffer length, must be >= RTUUID_STR_LENGTH.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
49d36b55bcf206ced156a303dab448a75fac001bvboxsyncRTDECL(int) RTUuidToStr(PCRTUUID pUuid, char *pszString, unsigned cchString)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync{
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /* validate parameters */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pUuid, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pszString, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(cchString >= RTUUID_STR_LENGTH, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /*
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * RTStrPrintf(,,"%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x",
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.u32TimeLow,
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.u16TimeMin,
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.u16TimeHiAndVersion,
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.u16ClockSeq & 0xff,
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.u16ClockSeq >> 8,
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.au8Node[0],
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.au8Node[1],
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.au8Node[2],
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.au8Node[3],
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.au8Node[4],
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * pUuid->Gen.au8Node[5]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync static const char s_achDigits[17] = "0123456789abcdef";
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync uint32_t u32TimeLow = pUuid->Gen.u32TimeLow;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 0] = s_achDigits[(u32TimeLow >> 28)/*& 0xf*/];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 1] = s_achDigits[(u32TimeLow >> 24) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 2] = s_achDigits[(u32TimeLow >> 20) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 3] = s_achDigits[(u32TimeLow >> 16) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 4] = s_achDigits[(u32TimeLow >> 12) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 5] = s_achDigits[(u32TimeLow >> 8) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 6] = s_achDigits[(u32TimeLow >> 4) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 7] = s_achDigits[(u32TimeLow/*>>0*/)& 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 8] = '-';
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync unsigned u = pUuid->Gen.u16TimeMid;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[ 9] = s_achDigits[(u >> 12)/*& 0xf*/];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[10] = s_achDigits[(u >> 8) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[11] = s_achDigits[(u >> 4) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[12] = s_achDigits[(u/*>>0*/)& 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[13] = '-';
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync u = pUuid->Gen.u16TimeHiAndVersion;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[14] = s_achDigits[(u >> 12)/*& 0xf*/];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[15] = s_achDigits[(u >> 8) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[16] = s_achDigits[(u >> 4) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[17] = s_achDigits[(u/*>>0*/)& 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[18] = '-';
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync u = pUuid->Gen.u16ClockSeq;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[19] = s_achDigits[(u >> 4) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[20] = s_achDigits[(u/*>>0*/)& 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[21] = s_achDigits[(u >> 12)/*& 0xf*/];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[22] = s_achDigits[(u >> 8) & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[23] = '-';
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[24] = s_achDigits[pUuid->Gen.au8Node[0] >> 4];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[25] = s_achDigits[pUuid->Gen.au8Node[0] & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[26] = s_achDigits[pUuid->Gen.au8Node[1] >> 4];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[27] = s_achDigits[pUuid->Gen.au8Node[1] & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[28] = s_achDigits[pUuid->Gen.au8Node[2] >> 4];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[29] = s_achDigits[pUuid->Gen.au8Node[2] & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[30] = s_achDigits[pUuid->Gen.au8Node[3] >> 4];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[31] = s_achDigits[pUuid->Gen.au8Node[3] & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[32] = s_achDigits[pUuid->Gen.au8Node[4] >> 4];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[33] = s_achDigits[pUuid->Gen.au8Node[4] & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[34] = s_achDigits[pUuid->Gen.au8Node[5] >> 4];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[35] = s_achDigits[pUuid->Gen.au8Node[5] & 0xf];
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pszString[36] = '\0';
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return VINF_SUCCESS;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync}
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync/**
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Converts UUID from its string representation to binary format.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync *
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @returns iprt status code.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pUuid Where to store result Uuid.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * @param pszString String with UUID text data.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
49d36b55bcf206ced156a303dab448a75fac001bvboxsyncRTDECL(int) RTUuidFromStr(PRTUUID pUuid, const char *pszString)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync{
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /* 0xff if not a hex number, otherwise the value. (Assumes UTF-8 encoded strings.) */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync static const uint8_t s_aDigits[256] =
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync {
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 0..0f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 10..1f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 20..2f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0x00,0x01,0x02,0x03, 0x04,0x05,0x06,0x07, 0x08,0x09,0xff,0xff, 0xff,0xff,0xff,0xff, /* 30..3f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0x0a,0x0b,0x0c, 0x0d,0x0e,0x0f,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 40..4f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 50..5f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0x0a,0x0b,0x0c, 0x0d,0x0e,0x0f,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 60..6f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 70..7f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 80..8f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* 90..9f */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* a0..af */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* b0..bf */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* c0..cf */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* d0..df */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* e0..ef */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, 0xff,0xff,0xff,0xff, /* f0..ff */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync };
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /*
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Validate parameters.
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pUuid, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync AssertReturn(pszString, VERR_INVALID_PARAMETER);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync#define MY_CHECK(expr) do { if (RT_UNLIKELY(!(expr))) return VERR_INVALID_UUID_FORMAT; } while (0)
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#define MY_ISXDIGIT(ch) (s_aDigits[(ch) & 0xff] != 0xff)
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 0]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 1]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 2]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 3]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 4]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 5]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 6]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 7]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(pszString[ 8] == '-');
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[ 9]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[10]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[11]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[12]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(pszString[13] == '-');
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[14]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[15]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[16]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[17]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(pszString[18] == '-');
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[19]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[20]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[21]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[22]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(pszString[23] == '-');
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[24]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[25]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[26]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[27]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[28]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[29]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[30]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[31]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[32]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[33]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[34]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(MY_ISXDIGIT(pszString[35]));
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync MY_CHECK(!pszString[36]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#undef MY_ISXDIGIT
fc4a2fc543a68aa923f84f47165c8fe044c0fb60vboxsync#undef MY_CHECK
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync /*
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync * Inverse of RTUuidToStr (see above).
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync */
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#define MY_TONUM(ch) (s_aDigits[(ch) & 0xff])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.u32TimeLow = (uint32_t)MY_TONUM(pszString[ 0]) << 28
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 1]) << 24
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 2]) << 20
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 3]) << 16
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 4]) << 12
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 5]) << 8
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 6]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint32_t)MY_TONUM(pszString[ 7]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.u16TimeMid = (uint16_t)MY_TONUM(pszString[ 9]) << 12
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[10]) << 8
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[11]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[12]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.u16TimeHiAndVersion =
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync (uint16_t)MY_TONUM(pszString[14]) << 12
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[15]) << 8
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[16]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[17]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.u16ClockSeq =(uint16_t)MY_TONUM(pszString[19]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[20])
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[21]) << 12
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint16_t)MY_TONUM(pszString[22]) << 8;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.au8Node[0] = (uint8_t)MY_TONUM(pszString[24]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint8_t)MY_TONUM(pszString[25]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.au8Node[1] = (uint8_t)MY_TONUM(pszString[26]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint8_t)MY_TONUM(pszString[27]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.au8Node[2] = (uint8_t)MY_TONUM(pszString[28]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint8_t)MY_TONUM(pszString[29]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.au8Node[3] = (uint8_t)MY_TONUM(pszString[30]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint8_t)MY_TONUM(pszString[31]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.au8Node[4] = (uint8_t)MY_TONUM(pszString[32]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint8_t)MY_TONUM(pszString[33]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync pUuid->Gen.au8Node[5] = (uint8_t)MY_TONUM(pszString[34]) << 4
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync | (uint8_t)MY_TONUM(pszString[35]);
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync#undef MY_TONUM
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync return VINF_SUCCESS;
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync}
c1ec0862a43a7fbb25c5e1f3243f67c1f787d4ebvboxsync