Class NumberHelper

Number helper library.

Methods to make numbers more readable.

Namespace: Cake\View\Helper
See: \Cake\I18n\Number
Link: https://book.cakephp.org/3.0/en/views/helpers/number.html

Property Summary

$_View protected

Cake\View\View

The View instance this helper is attached to
$_config protected

array

Runtime config
$_configInitialized protected

bool

Whether the config property has already been configured with defaults
$_defaultConfig protected

array

Default config for this class
$_engine protected

Cake\I18n\Number

Cake\I18n\Number instance
$_helperMap protected

array

A helper lookup table used to lazy load helper objects.
$fieldset public

array

Holds the fields ['field_name' => ['type' => 'string', 'length' => 100]], primaryKey and validates ['field_name']
$helpers public

array

List of helpers used by this helper
$plugin public

string

Plugin path
$request public

Cake\Http\ServerRequest

Request object
$tags public

array

Holds tag templates.
$theme public

string

The current theme name if any.

Method Summary

__call() public

Call methods from Cake\I18n\Number utility class
__construct() public

Default Constructor
__debugInfo() public

Returns an array that can be used to describe the internal state of this object.
__get() public

Lazy loads helpers.
_configDelete() protected

Deletes a single config key.
_configRead() protected

Reads a config key.
_configWrite() protected

Writes a config key.
_confirm() protected

Returns a string to be used as onclick handler for confirm dialogs.
addClass() public

Adds the given class to the element options
config() public deprecated

Gets/Sets the config.
configShallow() public

Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.
currency() public

Formats a number into a currency format.
defaultCurrency() public

Getter/setter for default currency
format() public

Formats a number into the correct locale format
formatDelta() public

Formats a number into the correct locale format to show deltas (signed differences in value).
getConfig() public

Returns the config.
getView() public

Get the view instance this helper is bound to.
implementedEvents() public

Event listeners.
initialize() public

Constructor hook method.
ordinal() public

Formats a number into locale specific ordinal suffix.
precision() public

Formats a number with a level of precision.
setConfig() public

Sets the config.
toPercentage() public

Formats a number into a percentage string.
toReadableSize() public

Returns a formatted-for-humans file size.

Method Detail

__call() ¶ public

__call(string $method, array $params): mixed

Call methods from Cake\I18n\Number utility class

Parameters

string $method: Method to invoke
array $params: Array of params for the method.

Returns

mixed

Whatever is returned by called method, or false on failure

__construct() ¶ public

__construct(Cake\View\View $View, array $config = [])

Default Constructor

Settings:

engine Class name to use to replace Cake\I18n\Number functionality The class needs to be placed in the Utility directory.

Parameters

Cake\View\View $View: The View this helper is being attached to.
array $config optional: Configuration settings for the helper

Throws

Cake\Core\Exception\Exception
When the engine class could not be found.

__debugInfo() ¶ public

__debugInfo(): array

Returns an array that can be used to describe the internal state of this object.

Returns

array

__get() ¶ public

__get(string $name): Cake\View\Helper|null

Lazy loads helpers.

Parameters

string $name: Name of the property being accessed.

Returns

Cake\View\Helper|null

Helper instance if helper with provided name exists

_configDelete() ¶ protected

_configDelete(string $key): void

Deletes a single config key.

Parameters

string $key: Key to delete.

Returns

void

Throws

Cake\Core\Exception\Exception
if attempting to clobber existing config

_configRead() ¶ protected

_configRead(string|null $key): mixed

Reads a config key.

Parameters

string|null $key: Key to read.

Returns

mixed

_configWrite() ¶ protected

_configWrite(string|array $key, mixed $value, bool|string $merge = false): void

Writes a config key.

Parameters

string|array $key: Key to write to.
mixed $value: Value to write.
bool|string $merge optional: True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.

Returns

void

Throws

Cake\Core\Exception\Exception
if attempting to clobber existing config

_confirm() ¶ protected

_confirm(string $message, string $okCode, string $cancelCode = '', array $options = []): string

Returns a string to be used as onclick handler for confirm dialogs.

Parameters

string $message: Message to be displayed
string $okCode: Code to be executed after user chose 'OK'
string $cancelCode optional: Code to be executed after user chose 'Cancel'
array $options optional: Array of options

Returns

string

onclick JS code

addClass() ¶ public

addClass(array $options = [], string|null $class = null, string $key = 'class'): array

Adds the given class to the element options

Parameters

array $options optional: Array options/attributes to add a class to
string|null $class optional: The class name being added.
string $key optional: the key to use for class.

Returns

array

Array of options with $key set.

config() ¶ public

config(string|array|null $key = null, mixed|null $value = null, bool $merge = true): mixed

Gets/Sets the config.

Usage

Reading the whole config:

$this->config();

Reading a specific value:

$this->config('key');

Reading a nested value:

$this->config('some.nested.key');

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array|null $key optional: The key to get/set, or a complete array of configs.
mixed|null $value optional: The value to set.
bool $merge optional: Whether to recursively merge or overwrite existing config, defaults to true.

Returns

mixed

Config value being read, or the object itself on write operations.

Throws

Cake\Core\Exception\Exception
When trying to set a key that is invalid.

configShallow() ¶ public

configShallow(string|array $key, mixed|null $value = null): $this

Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.

Setting a specific value:

$this->configShallow('key', $value);

Setting a nested value:

$this->configShallow('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->configShallow(['one' => 'value', 'another' => 'value']);

Parameters

string|array $key: The key to set, or a complete array of configs.
mixed|null $value optional: The value to set.

Returns

$this

currency() ¶ public

currency(float $number, string|null $currency = null, array $options = []): string

Formats a number into a currency format.

Options

locale - The locale name to use for formatting the number, e.g. fr_FR
fractionSymbol - The currency symbol to use for fractional numbers.
fractionPosition - The position the fraction symbol should be placed valid options are 'before' & 'after'.
before - Text to display before the rendered number
after - Text to display after the rendered number
zero - The text to use for zero values, can be a string or a number. e.g. 0, 'Free!'
places - Number of decimal places to use. e.g. 2
precision - Maximum Number of decimal places to use, e.g. 2
pattern - An ICU number pattern to use for formatting the number. e.g #,###.00
useIntlCode - Whether or not to replace the currency symbol with the international currency code.
escape - Whether or not to escape html in resulting string

Parameters

float $number: Value to format.
string|null $currency optional: International currency name such as 'USD', 'EUR', 'JPY', 'CAD'
array $options optional: Options list.

Returns

string

Number formatted as a currency.

defaultCurrency() ¶ public

defaultCurrency(string|bool $currency): string

Getter/setter for default currency

Parameters

string|bool $currency: Default currency string to be used by currency() if $currency argument is not provided. If boolean false is passed, it will clear the currently stored value

Returns

string

Currency

format() ¶ public

format(float $number, array $options = []): string

Formats a number into the correct locale format

Options:

places - Minimum number or decimals to use, e.g 0
precision - Maximum Number of decimal places to use, e.g. 2
locale - The locale name to use for formatting the number, e.g. fr_FR
before - The string to place before whole numbers, e.g. '['
after - The string to place after decimal numbers, e.g. ']'
escape - Whether or not to escape html in resulting string

Parameters

float $number: A floating point number.
array $options optional: An array with options.

Returns

string

Formatted number

Links

https://book.cakephp.org/3.0/en/views/helpers/number.html#formatting-numbers

formatDelta() ¶ public

formatDelta(float $value, array $options = []): string

Formats a number into the correct locale format to show deltas (signed differences in value).

Options

places - Minimum number or decimals to use, e.g 0
precision - Maximum Number of decimal places to use, e.g. 2
locale - The locale name to use for formatting the number, e.g. fr_FR
before - The string to place before whole numbers, e.g. '['
after - The string to place after decimal numbers, e.g. ']'
escape - Set to false to prevent escaping

Parameters

float $value: A floating point number
array $options optional: Options list.

Returns

string

formatted delta

getConfig() ¶ public

getConfig(string|null $key = null): mixed

Returns the config.

Usage

Reading the whole config:

$this->getConfig();

Reading a specific value:

$this->getConfig('key');

Reading a nested value:

$this->getConfig('some.nested.key');

Parameters

string|null $key optional: The key to get or null for the whole config.

Returns

mixed

Config value being read.

getView() ¶ public

getView(): Cake\View\View

Get the view instance this helper is bound to.

Returns

Cake\View\View

The bound view instance.

implementedEvents() ¶ public

implementedEvents(): array

Event listeners.

By defining one of the callback methods a helper is assumed to be interested in the related event.

Override this method if you need to add non-conventional event listeners. Or if you want helpers to listen to non-standard events.

Returns

array

initialize() ¶ public

initialize(array $config): void

Constructor hook method.

Implement this method to avoid having to overwrite the constructor and call parent.

Parameters

array $config: The configuration settings provided to this helper.

Returns

void

ordinal() ¶ public

ordinal(int|float $value, array $options = []): string

Formats a number into locale specific ordinal suffix.

Parameters

int|float $value: An integer
array $options optional: An array with options.

Returns

string

formatted number

precision() ¶ public

precision(float $number, int $precision = 3): string

Formats a number with a level of precision.

Parameters

float $number: A floating point number.
int $precision optional: The precision of the returned number.

Returns

string

Formatted float.

Links

https://book.cakephp.org/3.0/en/views/helpers/number.html#formatting-floating-point-numbers

setConfig() ¶ public

setConfig(string|array $key, mixed|null $value = null, bool $merge = true): $this

Sets the config.

Usage

Setting a specific value:

$this->setConfig('key', $value);

Setting a nested value:

$this->setConfig('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->setConfig(['one' => 'value', 'another' => 'value']);

Parameters

string|array $key: The key to set, or a complete array of configs.
mixed|null $value optional: The value to set.
bool $merge optional: Whether to recursively merge or overwrite existing config, defaults to true.

Returns

$this

Throws

Cake\Core\Exception\Exception
When trying to set a key that is invalid.

toPercentage() ¶ public

toPercentage(float $number, int $precision = 2, array $options = []): string

Formats a number into a percentage string.

Options:

multiply: Multiply the input value by 100 for decimal percentages.

Parameters

float $number: A floating point number
int $precision optional: The precision of the returned number
array $options optional: Options

Returns

string

Percentage string

Links

https://book.cakephp.org/3.0/en/views/helpers/number.html#formatting-percentages

toReadableSize() ¶ public

toReadableSize(int $size): string

Returns a formatted-for-humans file size.

Parameters

int $size: Size in bytes

Returns

string

Human readable size

Links

https://book.cakephp.org/3.0/en/views/helpers/number.html#interacting-with-human-readable-values

Class NumberHelper

Property Summary

Method Summary

__call() public

__construct() public

__debugInfo() public

__get() public

_configDelete() protected

_configRead() protected

_configWrite() protected

_confirm() protected

addClass() public

config() public deprecated

configShallow() public

currency() public

defaultCurrency() public

format() public

formatDelta() public

getConfig() public

getView() public

implementedEvents() public

initialize() public

ordinal() public

precision() public

setConfig() public

toPercentage() public

toReadableSize() public

Method Detail

__call() ¶ public

Parameters

Returns

__construct() ¶ public

Settings:

Parameters

Throws

__debugInfo() ¶ public

Returns

__get() ¶ public

Parameters

Returns

_configDelete() ¶ protected

Parameters

Returns

Throws

_configRead() ¶ protected

Parameters

Returns

_configWrite() ¶ protected

Parameters

Returns

Throws

_confirm() ¶ protected

Parameters

Returns

addClass() ¶ public

Parameters

Returns

config() ¶ public

Usage

Parameters

Returns

Throws

configShallow() ¶ public

Parameters

Returns

currency() ¶ public

Options

Parameters

Returns

defaultCurrency() ¶ public

Parameters

Returns

format() ¶ public

Parameters

Returns

Links

formatDelta() ¶ public

Options

Parameters

`$_View` ¶ protected

`$_config` ¶ protected

`$_configInitialized` ¶ protected

`$_defaultConfig` ¶ protected

`$_engine` ¶ protected

`$_helperMap` ¶ protected

`$fieldset` ¶ public

`$helpers` ¶ public

`$plugin` ¶ public

`$request` ¶ public

`$tags` ¶ public

`$theme` ¶ public