ListFormatter

Kotlin |Java

public final class ListFormatter
extends Object

java.lang.Object
↳	android.icu.text.ListFormatter

Immutable class for formatting a list, using data from CLDR (or supplied separately). The class is not subclassable.

Summary

Public methods
`String`	`format(Object... items)` Format a list of objects.
`String`	`format(Collection<?> items)` Format a collection of objects.
`static ListFormatter`	`getInstance(ULocale locale)` Create a list formatter that is appropriate for a locale.
`static ListFormatter`	`getInstance(Locale locale)` Create a list formatter that is appropriate for a locale.
`static ListFormatter`	`getInstance()` Create a list formatter that is appropriate for the default FORMAT locale.
`String`	`getPatternForNumItems(int count)` Returns the pattern to use for a particular item count.

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.

Added in API level 26

public String format (Object... items)

Format a list of objects.

Parameters
`items`	`Object`: items to format. The toString() method is called on each.

Returns
`String`	items formatted into a string

Added in API level 26

public String format (Collection<?> items)

Format a collection of objects. The toString() method is called on each.

Parameters
`items`	`Collection`: items to format. The toString() method is called on each.

Returns
`String`	items formatted into a string

Added in API level 26

public static ListFormatter getInstance (ULocale locale)

Create a list formatter that is appropriate for a locale.

Parameters
`locale`	`ULocale`: the locale in question.

Returns
`ListFormatter`	ListFormatter

Added in API level 26

public static ListFormatter getInstance (Locale locale)

Create a list formatter that is appropriate for a locale.

Parameters
`locale`	`Locale`: the locale in question.

Returns
`ListFormatter`	ListFormatter

Added in API level 26

public static ListFormatter getInstance ()

Create a list formatter that is appropriate for the default FORMAT locale.

Returns
`ListFormatter`	ListFormatter

Added in API level 26

public String getPatternForNumItems (int count)

Returns the pattern to use for a particular item count.

Parameters
`count`	`int`: the item count.

Returns
`String`	the pattern with {0}, {1}, {2}, etc. For English, getPatternForNumItems(3) == "{0}, {1}, and {2}"

Throws
`IllegalArgumentException`	when count is 0 or negative.