MessageValue.php

Go to the documentation of this file.

<?php
 
namespace Wikimedia\Message;
 
use Stringable;
 
class MessageValue {
    private $key;
 
    private $params;
 
    public function __construct( $key, $params = [] ) {
        $this->key = $key;
        $this->params = [];
        $this->params( ...$params );
    }
 
    public static function new( $key, $params = [] ) {
        return new MessageValue( $key, $params );
    }
 
    public function getKey() {
        return $this->key;
    }
 
    public function getParams() {
        return $this->params;
    }
 
    public function params( ...$values ) {
        foreach ( $values as $value ) {
            if ( $value instanceof MessageParam ) {
                $this->params[] = $value;
            } else {
                $this->params[] = new ScalarParam( ParamType::TEXT, $value );
            }
        }
        return $this;
    }
 
    public function textParamsOfType( $type, ...$values ) {
        foreach ( $values as $value ) {
            $this->params[] = new ScalarParam( $type, $value );
        }
        return $this;
    }
 
    public function objectParams( ...$values ) {
        foreach ( $values as $value ) {
            $this->params[] = new ScalarParam( ParamType::OBJECT, $value );
        }
        return $this;
    }
 
    public function listParamsOfType( $listType, ...$values ) {
        foreach ( $values as $value ) {
            $this->params[] = new ListParam( $listType, $value );
        }
        return $this;
    }
 
    public function textParams( ...$values ) {
        return $this->textParamsOfType( ParamType::TEXT, ...$values );
    }
 
    public function numParams( ...$values ) {
        return $this->textParamsOfType( ParamType::NUM, ...$values );
    }
 
    public function longDurationParams( ...$values ) {
        return $this->textParamsOfType( ParamType::DURATION_LONG, ...$values );
    }
 
    public function shortDurationParams( ...$values ) {
        return $this->textParamsOfType( ParamType::DURATION_SHORT, ...$values );
    }
 
    public function expiryParams( ...$values ) {
        return $this->textParamsOfType( ParamType::EXPIRY, ...$values );
    }
 
    public function dateTimeParams( ...$values ) {
        return $this->textParamsOfType( ParamType::DATETIME, ...$values );
    }
 
    public function dateParams( ...$values ) {
        return $this->textParamsOfType( ParamType::DATE, ...$values );
    }
 
    public function timeParams( ...$values ) {
        return $this->textParamsOfType( ParamType::TIME, ...$values );
    }
 
    public function userGroupParams( ...$values ) {
        return $this->textParamsOfType( ParamType::GROUP, ...$values );
    }
 
    public function sizeParams( ...$values ) {
        return $this->textParamsOfType( ParamType::SIZE, ...$values );
    }
 
    public function bitrateParams( ...$values ) {
        return $this->textParamsOfType( ParamType::BITRATE, ...$values );
    }
 
    public function rawParams( ...$values ) {
        return $this->textParamsOfType( ParamType::RAW, ...$values );
    }
 
    public function plaintextParams( ...$values ) {
        return $this->textParamsOfType( ParamType::PLAINTEXT, ...$values );
    }
 
    public function commaListParams( ...$values ) {
        return $this->listParamsOfType( ListType::COMMA, ...$values );
    }
 
    public function semicolonListParams( ...$values ) {
        return $this->listParamsOfType( ListType::SEMICOLON, ...$values );
    }
 
    public function pipeListParams( ...$values ) {
        return $this->listParamsOfType( ListType::PIPE, ...$values );
    }
 
    public function textListParams( ...$values ) {
        return $this->listParamsOfType( ListType::AND, ...$values );
    }
 
    public function dump() {
        $contents = '';
        foreach ( $this->params as $param ) {
            $contents .= $param->dump();
        }
        return '<message key="' . htmlspecialchars( $this->key ) . '">' .
            $contents . '</message>';
    }
}