DecodeUint128 decodes a 128-bit unsigned integer from the given offset. Returns the value as high and low 64-bit unsigned integers.

Helper function to create reasonable test names from potentially long hex strings.

No pow or bit shifting for big int, apparently :-( This is _not_ meant to be a comprehensive power function.

readNodePairBySize reads both left (bit=0) and right (bit=1) child pointers for a node at the given base offset according to the record size. This red

resolveCtrlData resolves at most one pointer starting at offset and returns the control data for the non-pointer value. Unlike decodeCtrlData, which r

We store IPv4 addresses at ::/96 for unclear reasons.

validateTag performs basic validation of maxminddb struct tags.

wrapErrorWithMapKey wraps an error with map key context, building path retroactively. Zero allocation on happy path - only allocates when error != nil

BuildPath constructs a path string for the current decoder state. This is only called when an error occurs, so allocation is acceptable.

IncludeAliasedNetworks is an option for Networks and NetworksWithin that makes them iterate over aliases of the IPv4 subtree in an IPv6 database, e.g.

Offset returns the current offset position in the database. If the current position points to a pointer, this method resolves one pointer and returns

ReadFloat32 reads the value pointed by the decoder as a float32. Returns an error if the database is malformed or if the pointed value is not a float

ReadInt32 reads the value pointed by the decoder as an int32. Returns an error if the database is malformed or if the pointed value is not an int32.

VerifyDataSection verifies the data section against the provided offsets from the tree.

decodeBytes decodes a byte slice from the given offset with the given size.

decodePointerKeyFast is an allocation-free inline of decodePointer followed by decodeKey for the dominant case of a map key encoded as a pointer to a

fieldByIndex efficiently accesses a field by its index path, initializing embedded pointers as needed.

getEmbeddedStructType returns the struct type for embedded fields. Returns nil if the field is not an embeddable struct type.

handleEmbeddedField processes an embedded struct field and returns true if the field should be skipped.

indirect handles pointer dereferencing and initialization.

isFastDecodeType determines if a field type can use optimized decode paths.

makeAddressable converts a reflect.Value to addressableValue, short-circuiting the reflect.New allocation when the value is already addressable. Non-a

parseSimpleInt converts numeric strings to integers with bounds checking. Returns the integer and true if valid, or 0 and false if not a simple intege

reindex optimizes field indices to avoid bounds checks during runtime. This follows the json/v2 pattern of splitting the first index from the remainde

tryFastDecodeTyped returns (newOffset, true) on success and (0, false) on any failure: a malformed buffer, a DB-type/Go-kind mismatch, or an inner dec

unwrapPtrType strips all pointer indirection from t and returns the underlying element type. Used to find the addressable receiver type that mayImplem

wrapError wraps an error with context information when an error occurs. Zero allocation on happy path - only allocates when error != nil.

wrapErrorAtOffset wraps an error with context at a specific offset. Used when the error occurs at a different offset than the decoder's current positi

wrapErrorWithSliceIndex wraps an error with slice index context, building path retroactively. Zero allocation on happy path - only allocates when erro

benchmarkCity mirrors geoip2-golang's City result shape, and the city lookup benchmarks below also populate Traits.IPAddress and Traits.Network to mat

BenchmarkCityLookupConcurrent tests concurrent city lookups to demonstrate string cache performance under concurrent load.

BenchmarkFieldLookup tests the performance of field lookup with the optimized field maps.

BenchmarkSimpleDecoding tests basic decoding performance.

Map with: "en"->"Foo" BenchmarkStructDecoding tests the performance of struct decoding with the new optimized field access patterns.

Benchmark to show allocation only occurs on error path.

Benchmark to verify zero allocation on happy path.

BuildPath implements ErrorContextTracker interface.

DecodePath decodes the data value at offset and stores the value associated with the path in the value pointed at by v.