<?php
// both of these are provided by illuminate/database already but i feel like it makes sense to add these definitions regardless

if (!function_exists('starts_with')) {
    function starts_with(string $string, string $text): bool {
        return substr($string, 0, strlen($text)) === $text;
    }
}

if (!function_exists('ends_with')) {
    function ends_with(string $string, string $text): bool {
        return substr($string, 0 - strlen($text)) === $text;
    }
}

function dechex_pad(int $value, int $padding = 2): string {
    return str_pad(dechex($value), $padding, '0', STR_PAD_LEFT);
}

function array_rand_value(array $array, $fallback = null) {
    if (!$array)
        return $fallback;

    return $array[array_rand($array)];
}

function has_flag(int $flags, int $flag): bool {
    return ($flags & $flag) > 0;
}

function is_int_ex($value, int $boundary_low, int $boundary_high): bool {
    return is_int($value) && $value >= $boundary_low && $value <= $boundary_high;
}

function is_sbyte($value): bool {
    return is_int_ex($value, -0x80, 0x7F);
}

function is_byte($value): bool {
    return is_int_ex($value, 0x0, 0xFF);
}

function is_int16($value): bool {
    return is_int_ex($value, -0x8000, 0x7FFF);
}

function is_uint16($value): bool {
    return is_int_ex($value, 0x0, 0xFFFF);
}

function is_int32($value): bool {
    return is_int_ex($value, -0x80000000, 0x7FFFFFFF);
}

function is_uint32($value): bool {
    return is_int_ex($value, 0x0, 0xFFFFFFFF);
}

function is_int64($value): bool {
    return is_int_ex($value, -0x8000000000000000, 0x7FFFFFFFFFFFFFFF);
}

function is_uint64($value): bool {
    return is_int_ex($value, 0x0, 0xFFFFFFFFFFFFFFFF);
}