MediaWiki REL1_37
Public Member Functions | Static Public Member Functions | Private Attributes | List of all members
Wikimedia\Message\MessageValue Class Reference

Value object representing a message for i18n. More...

Inheritance diagram for Wikimedia\Message\MessageValue:
Inheritance graph
[legend]
Collaboration diagram for Wikimedia\Message\MessageValue:
Collaboration graph
[legend]

Public Member Functions

 __construct ( $key, $params=[])
 
 bitrateParams (... $values)
 Chainable mutator which adds parameters which are a number of bits per second (ParamType::BITRATE).
 
 commaListParams (... $values)
 Chainable mutator which adds comma lists (ListType::COMMA).
 
 dateParams (... $values)
 Chainable mutator which adds parameters which are a date timestamp (ParamType::DATE).
 
 dateTimeParams (... $values)
 Chainable mutator which adds parameters which are a date-time timestamp (ParamType::DATETIME).
 
 dump ()
 Dump the object for testing/debugging.
 
 expiryParams (... $values)
 Chainable mutator which adds parameters which are an expiry timestamp (ParamType::EXPIRY).
 
 getKey ()
 Get the message key.
 
 getParams ()
 Get the parameter array.
 
 listParamsOfType ( $listType,... $values)
 Chainable mutator which adds list parameters with a common type.
 
 longDurationParams (... $values)
 Chainable mutator which adds parameters which are a duration specified in seconds (ParamType::DURATION_LONG).
 
 numParams (... $values)
 Chainable mutator which adds numeric parameters (ParamType::NUM).
 
 params (... $values)
 Chainable mutator which adds text parameters and MessageParam parameters.
 
 pipeListParams (... $values)
 Chainable mutator which adds pipe lists (ListType::PIPE).
 
 plaintextParams (... $values)
 Chainable mutator which adds plaintext parameters (ParamType::PLAINTEXT).
 
 rawParams (... $values)
 Chainable mutator which adds "raw" parameters (ParamType::RAW).
 
 semicolonListParams (... $values)
 Chainable mutator which adds semicolon lists (ListType::SEMICOLON).
 
 shortDurationParams (... $values)
 Chainable mutator which adds parameters which are a duration specified in seconds (ParamType::DURATION_SHORT).
 
 sizeParams (... $values)
 Chainable mutator which adds parameters which are a number of bytes (ParamType::SIZE).
 
 textListParams (... $values)
 Chainable mutator which adds natural-language lists (ListType::AND).
 
 textParams (... $values)
 Chainable mutator which adds parameters of type text (ParamType::TEXT).
 
 textParamsOfType ( $type,... $values)
 Chainable mutator which adds text parameters with a common type.
 
 timeParams (... $values)
 Chainable mutator which adds parameters which are a time timestamp (ParamType::TIME).
 

Static Public Member Functions

static new ( $key, $params=[])
 Static constructor for easier chaining of ->params() methods.
 

Private Attributes

string $key
 
MessageParam[] $params
 

Detailed Description

Value object representing a message for i18n.

A MessageValue holds a key and an array of parameters. It can be converted to a string in a particular language using formatters obtained from an IMessageFormatterFactory.

MessageValues are pure value objects and are safely newable.

@newable

Definition at line 16 of file MessageValue.php.

Constructor & Destructor Documentation

◆ __construct()

Wikimedia\Message\MessageValue::__construct (   $key,
  $params = [] 
)
Stability: stable
to call
Parameters
string$key
(MessageParam|MessageValue|string|int|float)[]$params Values that are not instances of MessageParam are wrapped using ParamType::TEXT.

Definition at line 30 of file MessageValue.php.

References Wikimedia\Message\MessageValue\$key, and Wikimedia\Message\MessageValue\params().

Member Function Documentation

◆ bitrateParams()

Wikimedia\Message\MessageValue::bitrateParams (   $values)

Chainable mutator which adds parameters which are a number of bits per second (ParamType::BITRATE).

Parameters
int|float...$values
Returns
$this

Definition at line 219 of file MessageValue.php.

References Wikimedia\Message\ParamType\BITRATE, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ commaListParams()

Wikimedia\Message\MessageValue::commaListParams (   $values)

Chainable mutator which adds comma lists (ListType::COMMA).

The list parameters thus created are formatted as a comma-separated list, or some local equivalent.

Parameters
(MessageParam|MessageValue|string|int|float)[]...$values Each value is an array of items suitable to pass as $params to ListParam::__construct()
Returns
$this

Definition at line 261 of file MessageValue.php.

References Wikimedia\Message\ListType\COMMA, and Wikimedia\Message\MessageValue\listParamsOfType().

◆ dateParams()

Wikimedia\Message\MessageValue::dateParams (   $values)

Chainable mutator which adds parameters which are a date timestamp (ParamType::DATE).

Since
1.36
Parameters
string...$values Timestamp as accepted by the Wikimedia\Timestamp library.
Returns
$this

Definition at line 187 of file MessageValue.php.

References Wikimedia\Message\ParamType\DATE, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ dateTimeParams()

Wikimedia\Message\MessageValue::dateTimeParams (   $values)

Chainable mutator which adds parameters which are a date-time timestamp (ParamType::DATETIME).

Since
1.36
Parameters
string...$values Timestamp as accepted by the Wikimedia\Timestamp library.
Returns
$this

Definition at line 176 of file MessageValue.php.

References Wikimedia\Message\ParamType\DATETIME, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ dump()

Wikimedia\Message\MessageValue::dump ( )

Dump the object for testing/debugging.

Returns
string

Reimplemented in Wikimedia\Message\DataMessageValue.

Definition at line 312 of file MessageValue.php.

References Wikimedia\Message\MessageValue\params().

◆ expiryParams()

Wikimedia\Message\MessageValue::expiryParams (   $values)

Chainable mutator which adds parameters which are an expiry timestamp (ParamType::EXPIRY).

Parameters
string...$values Timestamp as accepted by the Wikimedia\Timestamp library, or "infinity"
Returns
$this

Definition at line 165 of file MessageValue.php.

References Wikimedia\Message\ParamType\EXPIRY, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ getKey()

Wikimedia\Message\MessageValue::getKey ( )

Get the message key.

Returns
string

Definition at line 51 of file MessageValue.php.

References Wikimedia\Message\MessageValue\$key.

Referenced by MediaWiki\Message\Converter\convertMessageValue(), Wikimedia\Message\DataMessageValue\dump(), and MediaWiki\Api\Validator\ApiParamValidatorCallbacks\recordCondition().

◆ getParams()

Wikimedia\Message\MessageValue::getParams ( )

Get the parameter array.

Returns
MessageParam[]

Definition at line 60 of file MessageValue.php.

References Wikimedia\Message\MessageValue\$params.

Referenced by MediaWiki\Message\Converter\convertMessageValue(), Wikimedia\Message\DataMessageValue\dump(), and MediaWiki\Api\Validator\ApiParamValidatorCallbacks\recordCondition().

◆ listParamsOfType()

Wikimedia\Message\MessageValue::listParamsOfType (   $listType,
  $values 
)

Chainable mutator which adds list parameters with a common type.

Parameters
string$listTypeOne of the ListType constants
(MessageParam|MessageValue|string|int|float)[]...$values Each value is an array of items suitable to pass as $params to ListParam::__construct()
Returns
$this

Definition at line 103 of file MessageValue.php.

References Wikimedia\Message\MessageValue\params().

Referenced by Wikimedia\Message\MessageValue\commaListParams(), Wikimedia\Message\MessageValue\pipeListParams(), Wikimedia\Message\MessageValue\semicolonListParams(), and Wikimedia\Message\MessageValue\textListParams().

◆ longDurationParams()

Wikimedia\Message\MessageValue::longDurationParams (   $values)

Chainable mutator which adds parameters which are a duration specified in seconds (ParamType::DURATION_LONG).

This is similar to shorDurationParams() except that the result will be more verbose.

Parameters
int|float...$values
Returns
$this

Definition at line 140 of file MessageValue.php.

References Wikimedia\Message\ParamType\DURATION_LONG, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ new()

static Wikimedia\Message\MessageValue::new (   $key,
  $params = [] 
)
static

Static constructor for easier chaining of ->params() methods.

Parameters
string$key
(MessageParam|MessageValue|string|int|float)[]$params
Returns
MessageValue

Definition at line 42 of file MessageValue.php.

References Wikimedia\Message\MessageValue\$key, and Wikimedia\Message\MessageValue\$params.

◆ numParams()

Wikimedia\Message\MessageValue::numParams (   $values)

Chainable mutator which adds numeric parameters (ParamType::NUM).

Parameters
int|float...$values
Returns
$this

Definition at line 126 of file MessageValue.php.

References Wikimedia\Message\ParamType\NUM, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ params()

Wikimedia\Message\MessageValue::params (   $values)

Chainable mutator which adds text parameters and MessageParam parameters.

Parameters
MessageParam|MessageValue|string|int|float...$values
Returns
$this

Definition at line 70 of file MessageValue.php.

References Wikimedia\Message\MessageValue\params(), and Wikimedia\Message\ParamType\TEXT.

Referenced by Wikimedia\Message\MessageValue\__construct(), Wikimedia\Message\MessageValue\dump(), Wikimedia\Message\MessageValue\listParamsOfType(), Wikimedia\Message\MessageValue\params(), and Wikimedia\Message\MessageValue\textParamsOfType().

◆ pipeListParams()

Wikimedia\Message\MessageValue::pipeListParams (   $values)

Chainable mutator which adds pipe lists (ListType::PIPE).

The list parameters thus created are formatted as a pipe ("|") -separated list, or some local equivalent.

Parameters
(MessageParam|MessageValue|string|int|float)[]...$values Each value is an array of items suitable to pass as $params to ListParam::__construct()
Returns
$this

Definition at line 289 of file MessageValue.php.

References Wikimedia\Message\MessageValue\listParamsOfType(), and Wikimedia\Message\ListType\PIPE.

◆ plaintextParams()

Wikimedia\Message\MessageValue::plaintextParams (   $values)

Chainable mutator which adds plaintext parameters (ParamType::PLAINTEXT).

Plaintext parameters are substituted after formatter processing. The value will be escaped by the formatter as appropriate for the target output format so as to be represented as plain text rather than as any sort of markup.

Parameters
string...$values
Returns
$this

Definition at line 247 of file MessageValue.php.

References Wikimedia\Message\ParamType\PLAINTEXT, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ rawParams()

Wikimedia\Message\MessageValue::rawParams (   $values)

Chainable mutator which adds "raw" parameters (ParamType::RAW).

Raw parameters are substituted after formatter processing. The caller is responsible for ensuring that the value will be safe for the intended output format, and documenting what that intended output format is.

Parameters
string...$values
Returns
$this

Definition at line 233 of file MessageValue.php.

References Wikimedia\Message\ParamType\RAW, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ semicolonListParams()

Wikimedia\Message\MessageValue::semicolonListParams (   $values)

Chainable mutator which adds semicolon lists (ListType::SEMICOLON).

The list parameters thus created are formatted as a semicolon-separated list, or some local equivalent.

Parameters
(MessageParam|MessageValue|string|int|float)[]...$values Each value is an array of items suitable to pass as $params to ListParam::__construct()
Returns
$this

Definition at line 275 of file MessageValue.php.

References Wikimedia\Message\MessageValue\listParamsOfType(), and Wikimedia\Message\ListType\SEMICOLON.

◆ shortDurationParams()

Wikimedia\Message\MessageValue::shortDurationParams (   $values)

Chainable mutator which adds parameters which are a duration specified in seconds (ParamType::DURATION_SHORT).

This is similar to longDurationParams() except that the result will be more compact.

Parameters
int|float...$values
Returns
$this

Definition at line 154 of file MessageValue.php.

References Wikimedia\Message\ParamType\DURATION_SHORT, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ sizeParams()

Wikimedia\Message\MessageValue::sizeParams (   $values)

Chainable mutator which adds parameters which are a number of bytes (ParamType::SIZE).

Parameters
int...$values
Returns
$this

Definition at line 208 of file MessageValue.php.

References Wikimedia\Message\ParamType\SIZE, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ textListParams()

Wikimedia\Message\MessageValue::textListParams (   $values)

Chainable mutator which adds natural-language lists (ListType::AND).

The list parameters thus created, when formatted, are joined as in natural language. In English, this means a comma-separated list, with the last two elements joined with "and".

Parameters
(MessageParam|string)[]...$values
Returns
$this

Definition at line 303 of file MessageValue.php.

References Wikimedia\Message\ListType\AND, and Wikimedia\Message\MessageValue\listParamsOfType().

◆ textParams()

Wikimedia\Message\MessageValue::textParams (   $values)

Chainable mutator which adds parameters of type text (ParamType::TEXT).

Parameters
MessageValue|string|int|float...$values
Returns
$this

Definition at line 116 of file MessageValue.php.

References Wikimedia\Message\ParamType\TEXT, and Wikimedia\Message\MessageValue\textParamsOfType().

◆ textParamsOfType()

Wikimedia\Message\MessageValue::textParamsOfType (   $type,
  $values 
)

Chainable mutator which adds text parameters with a common type.

Parameters
string$typeOne of the ParamType constants
MessageValue|string|int|float...$values Scalar values
Returns
$this

Definition at line 88 of file MessageValue.php.

References $type, and Wikimedia\Message\MessageValue\params().

Referenced by Wikimedia\Message\MessageValue\bitrateParams(), Wikimedia\Message\MessageValue\dateParams(), Wikimedia\Message\MessageValue\dateTimeParams(), Wikimedia\Message\MessageValue\expiryParams(), Wikimedia\Message\MessageValue\longDurationParams(), Wikimedia\Message\MessageValue\numParams(), Wikimedia\Message\MessageValue\plaintextParams(), Wikimedia\Message\MessageValue\rawParams(), Wikimedia\Message\MessageValue\shortDurationParams(), Wikimedia\Message\MessageValue\sizeParams(), Wikimedia\Message\MessageValue\textParams(), and Wikimedia\Message\MessageValue\timeParams().

◆ timeParams()

Wikimedia\Message\MessageValue::timeParams (   $values)

Chainable mutator which adds parameters which are a time timestamp (ParamType::TIME).

Since
1.36
Parameters
string...$values Timestamp as accepted by the Wikimedia\Timestamp library.
Returns
$this

Definition at line 198 of file MessageValue.php.

References Wikimedia\Message\MessageValue\textParamsOfType(), and Wikimedia\Message\ParamType\TIME.

Member Data Documentation

◆ $key

string Wikimedia\Message\MessageValue::$key
private

Definition at line 18 of file MessageValue.php.

Referenced by Wikimedia\Message\MessageValue\__construct(), Wikimedia\Message\DataMessageValue\__construct(), Wikimedia\Message\MessageValue\getKey(), Wikimedia\Message\MessageValue\new(), and Wikimedia\Message\DataMessageValue\new().

◆ $params

MessageParam [] Wikimedia\Message\MessageValue::$params
private

Definition at line 21 of file MessageValue.php.

Referenced by Wikimedia\Message\DataMessageValue\__construct(), Wikimedia\Message\MessageValue\getParams(), Wikimedia\Message\MessageValue\new(), and Wikimedia\Message\DataMessageValue\new().

The documentation for this class was generated from the following file: