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() - 属性を設定する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.