NumberFormatter::setTextAttribute

numfmt_set_text_attribute

Set a text attribute

&reftitle.description;

&style.oop;

public `bool` `NumberFormatter::setTextAttribute` `int` `attribute` `string` `value`

&style.procedural;

`bool` `numfmt_set_text_attribute` `NumberFormatter` `formatter` `int` `attribute` `string` `value`

Set a text attribute associated with the formatter. An example of a text attribute is the suffix for positive numbers. If the formatter does not understand the attribute, `U_UNSUPPORTED_ERROR` error is produced. Rule-based formatters only understand `NumberFormatter::DEFAULT_RULESET` and `NumberFormatter::PUBLIC_RULESETS`.

&reftitle.parameters;

`formatter`

- `NumberFormatter` object.

`attribute`

- Attribute specifier - one of the text attribute constants.

`value`

- Text for the attribute value.

&reftitle.returnvalues;

&return.success;

&reftitle.examples;

### `numfmt_set_text_attribute` example

    <?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";
    ?>

### OO example

    <?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";
    ?>

&example.outputs;

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

&reftitle.seealso;

- `numfmt_get_error_code`
- `numfmt_get_text_attribute`
- `numfmt_set_attribute`