Revision b9beba72c3bb808c7905a64174ec1e8e3c16f810 authored by Lilith Orion Hafner on 23 July 2024, 15:52:24 UTC, committed by Lilith Orion Hafner on 23 July 2024, 15:52:38 UTC
1 parent fe207c5
uuid.jl
# This file is a part of Julia. License is MIT: https://julialang.org/license
"""
Represents a Universally Unique Identifier (UUID).
Can be built from one `UInt128` (all byte values), two `UInt64`, or four `UInt32`.
Conversion from a string will check the UUID validity.
"""
struct UUID
value::UInt128
end
UUID(u::UUID) = u
UUID(u::NTuple{2, UInt64}) = UUID((UInt128(u[1]) << 64) | UInt128(u[2]))
UUID(u::NTuple{4, UInt32}) = UUID((UInt128(u[1]) << 96) | (UInt128(u[2]) << 64) |
(UInt128(u[3]) << 32) | UInt128(u[4]))
function convert(::Type{NTuple{2, UInt64}}, uuid::UUID)
bytes = uuid.value
hi = UInt64((bytes >> 64) & 0xffffffffffffffff)
lo = UInt64(bytes & 0xffffffffffffffff)
return (hi, lo)
end
function convert(::Type{NTuple{4, UInt32}}, uuid::UUID)
bytes = uuid.value
hh = UInt32((bytes >> 96) & 0xffffffff)
hl = UInt32((bytes >> 64) & 0xffffffff)
lh = UInt32((bytes >> 32) & 0xffffffff)
ll = UInt32(bytes & 0xffffffff)
return (hh, hl, lh, ll)
end
UInt128(u::UUID) = u.value
let
uuid_hash_seed = UInt === UInt64 ? 0xd06fa04f86f11b53 : 0x96a1f36d
Base.hash(uuid::UUID, h::UInt) = hash(uuid_hash_seed, hash(convert(NTuple{2, UInt64}, uuid), h))
end
let
@inline function uuid_kernel(s, i, u)
_c = UInt32(@inbounds codeunit(s, i))
d = __convert_digit(_c, UInt32(16))
d >= 16 && return nothing
u <<= 4
return u | d
end
function Base.tryparse(::Type{UUID}, s::AbstractString)
u = UInt128(0)
ncodeunits(s) != 36 && return nothing
for i in 1:8
u = uuid_kernel(s, i, u)
u === nothing && return nothing
end
@inbounds codeunit(s, 9) == UInt8('-') || return nothing
for i in 10:13
u = uuid_kernel(s, i, u)
u === nothing && return nothing
end
@inbounds codeunit(s, 14) == UInt8('-') || return nothing
for i in 15:18
u = uuid_kernel(s, i, u)
u === nothing && return nothing
end
@inbounds codeunit(s, 19) == UInt8('-') || return nothing
for i in 20:23
u = uuid_kernel(s, i, u)
u === nothing && return nothing
end
@inbounds codeunit(s, 24) == UInt8('-') || return nothing
for i in 25:36
u = uuid_kernel(s, i, u)
u === nothing && return nothing
end
return Base.UUID(u)
end
end
let
@noinline throw_malformed_uuid(s) = throw(ArgumentError("Malformed UUID string: $(repr(s))"))
function Base.parse(::Type{UUID}, s::AbstractString)
uuid = tryparse(UUID, s)
return uuid === nothing ? throw_malformed_uuid(s) : uuid
end
end
UUID(s::AbstractString) = parse(UUID, s)
let groupings = [36:-1:25; 23:-1:20; 18:-1:15; 13:-1:10; 8:-1:1]
global string
function string(u::UUID)
u = u.value
a = Base.StringMemory(36)
for i in groupings
@inbounds a[i] = hex_chars[1 + u & 0xf]
u >>= 4
end
@inbounds a[24] = a[19] = a[14] = a[9] = '-'
return String(a)
end
end
print(io::IO, u::UUID) = print(io, string(u))
show(io::IO, u::UUID) = print(io, UUID, "(\"", u, "\")")
isless(a::UUID, b::UUID) = isless(a.value, b.value)
# give UUID scalar behavior in broadcasting
Base.broadcastable(x::UUID) = Ref(x)
Computing file changes ...