Changeset 11413 in vbox for trunk/include
- Timestamp:
- Aug 14, 2008 8:03:03 AM (16 years ago)
- Location:
- trunk/include/iprt
- Files:
-
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/include/iprt/types.h
r11347 r11413 1157 1157 /** 1158 1158 * UUID data type. 1159 * 1160 * @note IPRT defines that the first three integers in the @c Gen struct 1161 * interpretation are in little endian representation. This is different to 1162 * many other UUID implementation, and requires conversion if you need to 1163 * achieve consistent results. 1159 1164 */ 1160 1165 typedef union RTUUID … … 1168 1173 /** 64-bit view. */ 1169 1174 uint64_t au64[2]; 1170 /** The way the UUID is declared by the ext2 guys. */1175 /** The way the UUID is declared by the DCE specification. */ 1171 1176 struct 1172 1177 { … … 1174 1179 uint16_t u16TimeMid; 1175 1180 uint16_t u16TimeHiAndVersion; 1176 uint16_t u16ClockSeq; 1181 uint8_t u8ClockSeqHiAndReserved; 1182 uint8_t u8ClockSeqLow; 1177 1183 uint8_t au8Node[6]; 1178 1184 } Gen; -
trunk/include/iprt/uuid.h
r9743 r11413 44 44 * Generates new UUID value. 45 45 * 46 * @note IPRT uses little endian byte ordering in the UUID integer fields. If 47 * you want to pass IPRT UUIDs in binary representation to other UUID libraries 48 * and expect to get exactly the same string representation as in IPRT, you 49 * need to convert the first three integer fields (one 32 bit value, two 16 bit 50 * values) separately to big endian (also called network byte order). 51 * 52 * @sa RTUUID::Gen 53 * 46 54 * @returns iprt status code. 47 55 * @param pUuid Where to store generated uuid. … … 77 85 * Compares a UUID value with a UUID string. 78 86 * 87 * @note IPRT uses little endian byte ordering in the UUID integer fields. If 88 * you want to pass IPRT UUIDs in binary representation to other UUID libraries 89 * and expect to get exactly the same string representation as in IPRT, you 90 * need to convert the first three integer fields (one 32 bit value, two 16 bit 91 * values) separately to big endian (also called network byte order). 92 * Correspondingly, if you want to get the right result with UUIDs which are in 93 * big endian format, you need to convert them before using this function. 94 * 95 * @sa RTUUID::Gen 96 * 79 97 * @returns 0 if eq, < 0 or > 0. 80 98 * @param pUuid1 First value to compare. NULL is not allowed. … … 85 103 /** 86 104 * Converts binary UUID to its string representation. 105 * 106 * @note IPRT uses little endian byte ordering in the UUID integer fields. If 107 * you want to pass IPRT UUIDs in binary representation to other UUID libraries 108 * and expect to get exactly the same string representation as in IPRT, you 109 * need to convert the first three integer fields (one 32 bit value, two 16 bit 110 * values) separately to big endian (also called network byte order). 111 * Correspondingly, if you want to get the right result with UUIDs which are in 112 * big endian format, you need to convert them before using this function. 113 * 114 * @sa RTUUID::Gen 87 115 * 88 116 * @returns iprt status code. … … 95 123 /** 96 124 * Converts UUID from its string representation to binary format. 125 * 126 * @note IPRT uses little endian byte ordering in the UUID integer fields. If 127 * you want to pass IPRT UUIDs in binary representation to other UUID libraries 128 * and expect to get exactly the same string representation as in IPRT, you 129 * need to convert the first three integer fields (one 32 bit value, two 16 bit 130 * values) separately to big endian (also called network byte order). 131 * Correspondingly, if you want to get the right result with UUIDs which are in 132 * big endian format, you need to convert them before using this function. 133 * 134 * @sa RTUUID::Gen 97 135 * 98 136 * @returns iprt status code.
Note:
See TracChangeset
for help on using the changeset viewer.
