テキスト属性を設定する

# NumberFormatter::setTextAttribute

# numfmt_set_text_attribute

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

NumberFormatter::setTextAttribute -- numfmt_set_text_attribute — テキスト属性を設定する

### 説明

オブジェクト指向型

public function NumberFormatter::setTextAttribute(int `$attribute`, string `$value`): bool

手続き型

function numfmt_set_text_attribute(NumberFormatter `$formatter`, int `$attribute`, string `$value`): bool

フォーマッタに関連づけられているテキスト属性を設定します。 テキスト属性の例としては、正の数字のサフィックスなどがあります。 属性が理解できない場合は、エラー `U_UNSUPPORTED_ERROR` が発生します。 ルールベースのフォーマッタでは、 `NumberFormatter::DEFAULT_RULESET` および `NumberFormatter::PUBLIC_RULESETS` のみが使用できます。

### パラメータ

`formatter`

  NumberFormatter オブジェクト。

`attribute`

  属性指定子。 テキスト属性 定数のいずれか。

`value`

  属性の値を表すテキスト。

### 戻り値

成功した場合に `true` を、失敗した場合に `false` を返します。

### 例

例1 numfmt_set_text_attribute() の例

    <?php
    $fmt = numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
    echo "Prefix: ".numfmt_get_text_attribute($fmt, NumberFormatter::NEGATIVE_PREFIX)."\n";
    echo numfmt_format($fmt, -1234567.891234567890000)."\n";
    numfmt_set_text_attribute($fmt, NumberFormatter::NEGATIVE_PREFIX, "MINUS");
    echo "Prefix: ".numfmt_get_text_attribute($fmt, NumberFormatter::NEGATIVE_PREFIX)."\n";
    echo numfmt_format($fmt, -1234567.891234567890000)."\n";
    ?>

例2 オブジェクト指向の例

    <?php
    $fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
    echo "Prefix: ".$fmt->getTextAttribute(NumberFormatter::NEGATIVE_PREFIX)."\n";
    echo $fmt->format(-1234567.891234567890000)."\n";
    $fmt->setTextAttribute(NumberFormatter::NEGATIVE_PREFIX, "MINUS");
    echo "Prefix: ".$fmt->getTextAttribute(NumberFormatter::NEGATIVE_PREFIX)."\n";
    echo $fmt->format(-1234567.891234567890000)."\n";
    ?>

上の例の出力は以下となります。

    Prefix: -
    -1.234.567,891
    Prefix: MINUS
    MINUS1.234.567,891

### 参考

- numfmt_get_error_code() - フォーマッタの直近のエラーコードを取得する
- numfmt_get_text_attribute() - テキストの属性を取得する
- numfmt_set_attribute() - 属性を設定する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open