ini_parse_quantity

(PHP 8 >= 8.2.0)

ini_parse_quantity — Интерпретирует сокращение размера в значении ini-параметра

Описание

function ini_parse_quantity(string $shorthand): int

Функция интерпретирует и в случае успешного выполнения возвращает размер в байтах, который получила из сокращения значения ini-параметра.

Список параметров

shorthand: Сокращение значения ini-параметра для разбора. Параметр требует целое число, за которым следует необязательный множитель. Поддерживаются следующие множители: k или K — килобайт, 1024 байта; m или M — мегабайт, 1 048 576 байтов; g или G — гигабайт, 1 073 741 824 байта. Параметр принимает десятичные, шестнадцатеричные с префиксом 0x или 0X, восьмеричные с префиксом 0o, 0O или 0 и двоичные с префиксом 0b или 0B числа.

Возвращаемые значения

Функция возвращает размер в байтах в виде целого числа (int), который получила после интерпретации сокращения размера ini-значения.

Ошибки

Функция выдаёт ошибку уровня E_WARNING, если не смогла разобрать значение или встретила недопустимый множитель.

Примеры

Пример #1 Пример использования функции ini_parse_quantity()

<?php

var_dump(ini_parse_quantity('1024'));
var_dump(ini_parse_quantity('1024M'));
var_dump(ini_parse_quantity('512K'));
var_dump(ini_parse_quantity('0xFFk'));
var_dump(ini_parse_quantity('0b1010k'));
var_dump(ini_parse_quantity('0o1024'));
var_dump(ini_parse_quantity('01024'));
var_dump(ini_parse_quantity('Foobar'));
var_dump(ini_parse_quantity('10F'));

?>

Результат выполнения приведённого примера:

int(1024)
int(1073741824)
int(524288)
int(261120)
int(10240)
int(532)
int(532)

Warning: Invalid quantity "Foobar": no valid leading digits, interpreting as "0" for backwards compatibility
int(0)

Warning: Invalid quantity "10F": unknown multiplier "F", interpreting as "10" for backwards compatibility
int(10)

Смотрите также

ini_get() - Получает значение параметра конфигурации

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 1 note

down

php at SpamDeletToDotLLMsRefuse dot dunn dot eu dot org ¶

1 day ago

I made a very basic polyfill for this function, you're welcome to use

<?php
if(!function_exists('ini_parse_quantity')) {
    /**
     * Very basic polyfill for ini_parse_quantity
     * @license MPL-2.0
     * @license CC-BY-3.0
     */
    function ini_parse_quantity($shorthand) {
        $regex = '/^(0?[xXbBoO]?)([0-9A-Fa-f]*)([kKmMgG]?)$/';
        preg_match($regex, $shorthand, $matches);
        if(empty($matches)) {
            trigger_error('Can\'t parse '.$shorthand.' :(', E_USER_WARNING);
            return 0;
        }
        [ $full, $binOctHex, $value, $unit ] = $matches;
        switch ($binOctHex) {
            case '0b':
            case '0B':
                $base = 2;
                break;
            case '0o':
            case '0O':
            case '0':
                $base = 8;
                break;
            case '0x':
            case '0X':
                $base = 16;
                break;
            default:
                $base = 10;
                break;
        }
        $value = intval($value, $base);

        switch ($unit) {
            case 'g':
            case 'G':
                $value *= 1024;
            case 'm':
            case 'M':
                $value *= 1024;
            case 'k':
            case 'K':
                $value *= 1024;
            default:
                break;
        }
        return $value;
    }
}

＋Добавить