# Print output for @column tags ?>
Developers

- Design
- Develop
- Distribute

Developer Console

## Most visited

## Recently visited

## Results for

Summary: Ctors | Methods | Inherited Methods

# AttributedString

`public class AttributedString`
`extends Object` ``

java.lang.Object
↳ | java.text.AttributedString

An AttributedString holds text and related attribute information. It may be used as the actual data storage in some cases where a text reader wants to access attributed text through the AttributedCharacterIterator interface.

An attribute is a key/value pair, identified by the key. No two attributes on a given character can have the same key.

The values for an attribute are immutable, or must not be mutated by clients or storage. They are always passed by reference, and not cloned.

See also:

- `AttributedCharacterIterator`
- `Annotation`

## Summary

### Public constructors
`AttributedString(String text)` Constructs an AttributedString instance with the given text.
`AttributedString(String text, Map<? extends AttributedCharacterIterator.Attribute, ?> attributes)` Constructs an AttributedString instance with the given text and attributes.
`AttributedString(AttributedCharacterIterator text)` Constructs an AttributedString instance with the given attributed text represented by AttributedCharacterIterator.
`AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex)` Constructs an AttributedString instance with the subrange of the given attributed text represented by AttributedCharacterIterator.
`AttributedString(AttributedCharacterIterator text, int beginIndex, int endIndex, Attribute[] attributes)` Constructs an AttributedString instance with the subrange of the given attributed text represented by AttributedCharacterIterator.

### Public methods
`void` | `addAttribute(AttributedCharacterIterator.Attribute attribute, Object value)` Adds an attribute to the entire string.
`void` | `addAttribute(AttributedCharacterIterator.Attribute attribute, Object value, int beginIndex, int endIndex)` Adds an attribute to a subrange of the string.
`void` | `addAttributes(Map<? extends AttributedCharacterIterator.Attribute, ?> attributes, int beginIndex, int endIndex)` Adds a set of attributes to a subrange of the string.
`AttributedCharacterIterator` | `getIterator()` Creates an AttributedCharacterIterator instance that provides access to the entire contents of this string.
`AttributedCharacterIterator` | `getIterator(Attribute[] attributes)` Creates an AttributedCharacterIterator instance that provides access to selected contents of this string.
`AttributedCharacterIterator` | `getIterator(Attribute[] attributes, int beginIndex, int endIndex)` Creates an AttributedCharacterIterator instance that provides access to selected contents of this string.

### Inherited methods
From class `java.lang.Object`
`Object` | `clone()` Creates and returns a copy of this object.
`boolean` | `equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void` | `finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>` | `getClass()` Returns the runtime class of this `Object`.
`int` | `hashCode()` Returns a hash code value for the object.
`final void` | `notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void` | `notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String` | `toString()` Returns a string representation of the object.
`final void` | `wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void` | `wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void` | `wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

## Public constructors

### AttributedString

    public AttributedString (String text)

Constructs an AttributedString instance with the given text.

Parameters
`text` | `String`: The text for this attributed string.

Throws
`NullPointerException` | if `text` is null.

### AttributedString

    public AttributedString (String text,
                    Map<? extends AttributedCharacterIterator.Attribute, ?> attributes)

Constructs an AttributedString instance with the given text and attributes.

Parameters
`text` | `String`: The text for this attributed string.
`attributes` | `Map`: The attributes that apply to the entire string.

Throws
`NullPointerException` | if `text` or `attributes` is null.
`IllegalArgumentException` | if the text has length 0 and the attributes parameter is not an empty Map (attributes cannot be applied to a 0-length range).

### AttributedString

    public AttributedString (AttributedCharacterIterator text)

Constructs an AttributedString instance with the given attributed text represented by AttributedCharacterIterator.

Parameters
`text` | `AttributedCharacterIterator`: The text for this attributed string.

Throws
`NullPointerException` | if `text` is null.

### AttributedString

    public AttributedString (AttributedCharacterIterator text,
                    int beginIndex,
                    int endIndex)

Constructs an AttributedString instance with the subrange of the given attributed text represented by AttributedCharacterIterator. If the given range produces an empty text, all attributes will be discarded. Note that any attributes wrapped by an Annotation object are discarded for a subrange of the original attribute range.

Parameters
`text` | `AttributedCharacterIterator`: The text for this attributed string.
`beginIndex` | `int`: Index of the first character of the range.
`endIndex` | `int`: Index of the character following the last character of the range.

Throws
`NullPointerException` | if `text` is null.
`IllegalArgumentException` | if the subrange given by beginIndex and endIndex is out of the text range.

See also:

- `Annotation`

### AttributedString

    public AttributedString (AttributedCharacterIterator text,
                    int beginIndex,
                    int endIndex,
                    Attribute[] attributes)

Constructs an AttributedString instance with the subrange of the given attributed text represented by AttributedCharacterIterator. Only attributes that match the given attributes will be incorporated into the instance. If the given range produces an empty text, all attributes will be discarded. Note that any attributes wrapped by an Annotation object are discarded for a subrange of the original attribute range.

Parameters
`text` | `AttributedCharacterIterator`: The text for this attributed string.
`beginIndex` | `int`: Index of the first character of the range.
`endIndex` | `int`: Index of the character following the last character of the range.
`attributes` | `Attribute`: Specifies attributes to be extracted from the text. If null is specified, all available attributes will be used.

Throws
`NullPointerException` | if `text` is null.
`IllegalArgumentException` | if the subrange given by beginIndex and endIndex is out of the text range.

See also:

- `Annotation`

## Public methods

### addAttribute

    public void addAttribute (AttributedCharacterIterator.Attribute attribute,
                    Object value)

Adds an attribute to the entire string.

Parameters
`attribute` | `AttributedCharacterIterator.Attribute`: the attribute key
`value` | `Object`: the value of the attribute; may be null

Throws
`NullPointerException` | if `attribute` is null.
`IllegalArgumentException` | if the AttributedString has length 0 (attributes cannot be applied to a 0-length range).

### addAttribute

    public void addAttribute (AttributedCharacterIterator.Attribute attribute,
                    Object value,
                    int beginIndex,
                    int endIndex)

Adds an attribute to a subrange of the string.

Parameters
`attribute` | `AttributedCharacterIterator.Attribute`: the attribute key
`value` | `Object`: The value of the attribute. May be null.
`beginIndex` | `int`: Index of the first character of the range.
`endIndex` | `int`: Index of the character following the last character of the range.

Throws
`NullPointerException` | if `attribute` is null.
`IllegalArgumentException` | if beginIndex is less then 0, endIndex is greater than the length of the string, or beginIndex and endIndex together don't define a non-empty subrange of the string.

### addAttributes

    public void addAttributes (Map<? extends AttributedCharacterIterator.Attribute, ?> attributes,
                    int beginIndex,
                    int endIndex)

Adds a set of attributes to a subrange of the string.

Parameters
`attributes` | `Map`: The attributes to be added to the string.
`beginIndex` | `int`: Index of the first character of the range.
`endIndex` | `int`: Index of the character following the last character of the range.

Throws
`NullPointerException` | if `attributes` is null.
`IllegalArgumentException` | if beginIndex is less then 0, endIndex is greater than the length of the string, or beginIndex and endIndex together don't define a non-empty subrange of the string and the attributes parameter is not an empty Map.

### getIterator

    public AttributedCharacterIterator getIterator ()

Creates an AttributedCharacterIterator instance that provides access to the entire contents of this string.

Returns
`AttributedCharacterIterator` | An iterator providing access to the text and its attributes.

### getIterator

    public AttributedCharacterIterator getIterator (Attribute[] attributes)

Creates an AttributedCharacterIterator instance that provides access to selected contents of this string. Information about attributes not listed in attributes that the implementor may have need not be made accessible through the iterator. If the list is null, all available attribute information should be made accessible.

Parameters
`attributes` | `Attribute`: a list of attributes that the client is interested in

Returns
`AttributedCharacterIterator` | an iterator providing access to the entire text and its selected attributes

### getIterator

    public AttributedCharacterIterator getIterator (Attribute[] attributes,
                    int beginIndex,
                    int endIndex)

Creates an AttributedCharacterIterator instance that provides access to selected contents of this string. Information about attributes not listed in attributes that the implementor may have need not be made accessible through the iterator. If the list is null, all available attribute information should be made accessible.

Parameters
`attributes` | `Attribute`: a list of attributes that the client is interested in
`beginIndex` | `int`: the index of the first character
`endIndex` | `int`: the index of the character following the last character

Returns
`AttributedCharacterIterator` | an iterator providing access to the text and its attributes

Throws
`IllegalArgumentException` | if beginIndex is less then 0, endIndex is greater than the length of the string, or beginIndex is greater than endIndex.

Full name *
Email address *
Company / developer name
One of your Play Store app URLs *
Which best describes your business:*
Apps
Games
Apps & Games
*
*