https://github.com/JuliaLang/julia
Raw File
Tip revision: d634205f2ff5c0e4d351cf7d7dd4b80cf973cd5a authored by Fredrik Ekre on 19 August 2020, 10:59:49 UTC
WIP default depwarn.
Tip revision: d634205
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::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
@noinline throw_malformed_uuid(s) = throw(ArgumentError("Malformed UUID string: $(repr(s))"))
@inline function uuid_kernel(s, i, u)
    _c = UInt32(@inbounds codeunit(s, i))
    d = __convert_digit(_c, UInt32(16))
    d >= 16 && throw_malformed_uuid(s)
    u <<= 4
    u | d
end

global UUID
function UUID(s::AbstractString)
    u = UInt128(0)
    ncodeunits(s) != 36 && throw_malformed_uuid(s)
    for i in 1:8
        u = uuid_kernel(s, i, u)
    end
    @inbounds codeunit(s, 9) == UInt8('-') || @goto error
    for i in 10:13
        u = uuid_kernel(s, i, u)
    end
    @inbounds codeunit(s, 14) == UInt8('-') || @goto error
    for i in 15:18
        u = uuid_kernel(s, i, u)
    end
    @inbounds codeunit(s, 19) == UInt8('-') || @goto error
    for i in 20:23
        u = uuid_kernel(s, i, u)
    end
    @inbounds codeunit(s, 24) == UInt8('-') || @goto error
    for i in 25:36
        u = uuid_kernel(s, i, u)
    end
    return Base.UUID(u)
    @label error
    throw_malformed_uuid(s)
end
end

parse(::Type{UUID}, s::AbstractString) = 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.StringVector(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)
back to top