ConverterInterface
in
Конвертер единиц измерения.
Table of Contents
Methods
- convert() : float
- Конвертирует значение между единицами (float-путь, максимальная скорость).
- convertMany() : array<int, float>
- Конвертирует набор значений одной парой единиц (один расчёт пары).
- convertPrecise() : string
- Конвертация произвольной точности (BCMath): результат — десятичная строка.
- quantity() : Quantity
- Создаёт величину, привязанную к этому конвертеру.
- registry() : UnitRegistry
- Реестр единиц конвертера.
- toAll() : array<string, float>
- Конвертирует значение во все совместимые единицы категории или в заданный список целей.
- toCompound() : array<string, float>
- Раскладывает значение на составные единицы: 5025 с → 1 ч 23 мин 45 с.
- tryConvert() : float|null
- Конвертация без исключений: null при любой ошибке.
Methods
convert()
Конвертирует значение между единицами (float-путь, максимальная скорость).
public
convert(float $value, string|Unit $from, string|Unit $to) : float
Parameters
Tags
Return values
floatconvertMany()
Конвертирует набор значений одной парой единиц (один расчёт пары).
public
convertMany(iterable<string|int, int|float> $values, string|Unit $from, string|Unit $to) : array<int, float>
Parameters
Tags
Return values
array<int, float>convertPrecise()
Конвертация произвольной точности (BCMath): результат — десятичная строка.
public
convertPrecise(int|float|string $value, string|Unit $from, string|Unit $to[, null|int $scale = null ]) : string
Нелинейные единицы (топливная экономичность) вычисляются во float и возвращаются строкой — честное ограничение режима.
Parameters
- $value : int|float|string
- $from : string|Unit
- $to : string|Unit
- $scale : null|int = null
-
знаков после запятой результата; null — полная шкала
Tags
Return values
stringquantity()
Создаёт величину, привязанную к этому конвертеру.
public
quantity(float $value, string|Unit $unit) : Quantity
Parameters
- $value : float
- $unit : string|Unit
Tags
Return values
Quantityregistry()
Реестр единиц конвертера.
public
registry() : UnitRegistry
Return values
UnitRegistrytoAll()
Конвертирует значение во все совместимые единицы категории или в заданный список целей.
public
toAll(float $value, string|Unit $from[, null|array<int, string|Unit> $targets = null ]) : array<string, float>
Parameters
- $value : float
- $from : string|Unit
- $targets : null|array<int, string|Unit> = null
-
целевые единицы; null — вся категория
Tags
Return values
array<string, float> —код единицы → значение
toCompound()
Раскладывает значение на составные единицы: 5025 с → 1 ч 23 мин 45 с.
public
toCompound(float $value, string|Unit $from, array<int, string|Unit> $targets) : array<string, float>
Все цели, кроме последней, получают целые части; последняя — остаток.
Parameters
- $value : float
- $from : string|Unit
- $targets : array<int, string|Unit>
-
единицы разложения (крупные → мелкие)
Tags
Return values
array<string, float> —код единицы → значение
tryConvert()
Конвертация без исключений: null при любой ошибке.
public
tryConvert(float $value, string|Unit $from, string|Unit $to) : float|null