Added in API level 1

Attributes

open class Attributes : Cloneable, MutableMap<Any!, Any!>

kotlin.Any
↳	java.util.jar.Attributes

The Attributes class maps Manifest attribute names to associated string values. Valid attribute names are case-insensitive, are restricted to the ASCII characters in the set [0-9a-zA-Z_-], and cannot exceed 70 characters in length. There must be a colon and a SPACE after the name; the combined length will not exceed 72 characters. Attribute values can contain any characters and will be UTF8-encoded when written to the output stream. See the JAR File Specification for more information about valid attribute names and values.

This map and its views have a predictable iteration order, namely the order that keys were inserted into the map, as with LinkedHashMap.

Summary

Nested classes
open	`Name` The Attributes.

Public constructors
`Attributes()` Constructs a new, empty Attributes object with default size.
`Attributes(size: Int)` Constructs a new, empty Attributes object with the specified initial size.
`Attributes(attr: Attributes!)` Constructs a new Attributes object with the same attribute name-value mappings as in the specified Attributes.

Public methods
open Unit	`clear()` Removes all attributes from this Map.
open Any	`clone()` Returns a copy of the Attributes, implemented as follows: public Object clone() { return new Attributes(this); } Since the attribute names and values are themselves immutable, the Attributes returned can be safely modified without affecting the original.
open Boolean	`containsKey(key: Any!)` Returns true if this Map contains the specified attribute name (key).
open Boolean	`containsValue(value: Any!)` Returns true if this Map maps one or more attribute names (keys) to the specified value.
open Boolean	`equals(other: Any?)` Compares the specified object to the underlying map for equality.
open Any?	`get(key: Any!)` Returns the value of the specified attribute name, or null if the attribute name was not found.
open String!	`getValue(name: String!)` Returns the value of the specified attribute name, specified as a string, or null if the attribute was not found.
open String!	`getValue(name: Attributes.Name!)` Returns the value of the specified Attributes.
open Int	`hashCode()` Returns the hash code value for this Map.
open Boolean	`isEmpty()` Returns true if this Map contains no attributes.
open Any?	`put(key: Any!, value: Any!)` Associates the specified value with the specified attribute name (key) in this Map.
open Unit	`putAll(from: Map<, >)` Copies all of the attribute name-value mappings from the specified Attributes to this Map.
open String!	`putValue(name: String!, value: String!)` Associates the specified value with the specified attribute name, specified as a String.
open Any?	`remove(key: Any!)` Removes the attribute with the specified name (key) from this Map.

Properties
open MutableSet<MutableEntry<Any!, Any!>>	`entries` Returns a Collection view of the attribute name-value mappings contained in this Map.
open MutableSet<Any!>	`keys` Returns a Set view of the attribute names (keys) contained in this Map.
MutableMap<Any!, Any!>!	`map` The attribute name-value mappings.
open Int	`size` Returns the number of attributes in this Map.
open MutableCollection<Any!>	`values` Returns a Collection view of the attribute values contained in this Map.

Public constructors

Attributes

Added in API level 1

Attributes()

Constructs a new, empty Attributes object with default size.

Attributes

Added in API level 1

Attributes(size: Int)

Constructs a new, empty Attributes object with the specified initial size.

Parameters
`size`	Int: the initial number of attributes

Attributes

Added in API level 1

Attributes(attr: Attributes!)

Constructs a new Attributes object with the same attribute name-value mappings as in the specified Attributes.

Parameters
`attr`	Attributes!: the specified Attributes

Public methods

clear

Added in API level 1

open fun clear(): Unit

Removes all attributes from this Map.

Exceptions
`java.lang.UnsupportedOperationException`	if the `clear` operation is not supported by this map

clone

Added in API level 1

open fun clone(): Any

Returns a copy of the Attributes, implemented as follows:

public Object clone() { return new Attributes(this); }

Since the attribute names and values are themselves immutable, the Attributes returned can be safely modified without affecting the original.

Return
`Any`	a clone of this instance.

Exceptions
`java.lang.CloneNotSupportedException`	if the object's class does not support the `Cloneable` interface. Subclasses that override the `clone` method can also throw this exception to indicate that an instance cannot be cloned.

containsKey

Added in API level 1

open fun containsKey(key: Any!): Boolean

Returns true if this Map contains the specified attribute name (key).

Parameters
`key`	Any!: key whose presence in this map is to be tested
`name`	the attribute name

Return
`Boolean`	true if this Map contains the specified attribute name

Exceptions
`java.lang.ClassCastException`	if the key is of an inappropriate type for this map (java.util.Collection#)
`java.lang.NullPointerException`	if the specified key is null and this map does not permit null keys (java.util.Collection#)

containsValue

Added in API level 1

open fun containsValue(value: Any!): Boolean

Returns true if this Map maps one or more attribute names (keys) to the specified value.

Parameters
`value`	Any!: the attribute value

Return
`Boolean`	true if this Map maps one or more attribute names to the specified value

Exceptions
`java.lang.ClassCastException`	if the value is of an inappropriate type for this map (java.util.Collection#)
`java.lang.NullPointerException`	if the specified value is null and this map does not permit null values (java.util.Collection#)

equals

Added in API level 1

open fun equals(other: Any?): Boolean

Compares the specified object to the underlying map for equality. Returns true if the given object is also a Map and the two maps represent the same mappings.

Parameters
`obj`	the reference object with which to compare.
`o`	the Object to be compared

Return
`Boolean`	true if the specified Object is equal to this Map

get

Added in API level 1

open fun get(key: Any!): Any?

Returns the value of the specified attribute name, or null if the attribute name was not found.

Parameters
`key`	Any!: the key whose associated value is to be returned
`name`	the attribute name

Return
`Any?`	the value of the specified attribute name, or null if not found.

Exceptions
`java.lang.ClassCastException`	if the key is of an inappropriate type for this map (java.util.Collection#)
`java.lang.NullPointerException`	if the specified key is null and this map does not permit null keys (java.util.Collection#)

getValue

Added in API level 1

open fun getValue(name: String!): String!

Returns the value of the specified attribute name, specified as a string, or null if the attribute was not found. The attribute name is case-insensitive.

This method is defined as:

return (String)get(new Attributes.Name((String)name));

Parameters
`name`	String!: the attribute name as a string

Return
`String!`	the String value of the specified attribute name, or null if not found.

Exceptions
`java.lang.IllegalArgumentException`	if the attribute name is invalid

getValue

Added in API level 1

open fun getValue(name: Attributes.Name!): String!

Returns the value of the specified Attributes.Name, or null if the attribute was not found.

This method is defined as:

return (String)get(name);

Parameters
`name`	Attributes.Name!: the Attributes.Name object

Return
`String!`	the String value of the specified Attribute.Name, or null if not found.

hashCode

Added in API level 1

open fun hashCode(): Int

Returns the hash code value for this Map.

Return
`Int`	the hash code value for this map

isEmpty

Added in API level 1

open fun isEmpty(): Boolean

Returns true if this Map contains no attributes.

Return
`Boolean`	`true` if this map contains no key-value mappings

put

Added in API level 1

open fun put(
    key: Any!, 
    value: Any!
): Any?

Associates the specified value with the specified attribute name (key) in this Map. If the Map previously contained a mapping for the attribute name, the old value is replaced.

Parameters
`key`	Any!: key with which the specified value is to be associated
`value`	Any!: the attribute value
`name`	the attribute name

Return
`Any?`	the previous value of the attribute, or null if none

Exceptions
`java.lang.UnsupportedOperationException`	if the `put` operation is not supported by this map
`java.lang.ClassCastException`	if the name is not a Attributes.Name or the value is not a String
`java.lang.NullPointerException`	if the specified key or value is null and this map does not permit null keys or values
`java.lang.IllegalArgumentException`	if some property of the specified key or value prevents it from being stored in this map

putAll

Added in API level 1

open fun putAll(from: Map<*, *>): Unit

Copies all of the attribute name-value mappings from the specified Attributes to this Map. Duplicate mappings will be replaced.

Parameters
`m`	mappings to be stored in this map
`attr`	the Attributes to be stored in this map

Exceptions
`java.lang.UnsupportedOperationException`	if the `putAll` operation is not supported by this map
`java.lang.ClassCastException`	if attr is not an Attributes
`java.lang.NullPointerException`	if the specified map is null, or if this map does not permit null keys or values, and the specified map contains null keys or values
`java.lang.IllegalArgumentException`	if some property of a key or value in the specified map prevents it from being stored in this map

putValue

Added in API level 1

open fun putValue(
    name: String!, 
    value: String!
): String!

Associates the specified value with the specified attribute name, specified as a String. The attributes name is case-insensitive. If the Map previously contained a mapping for the attribute name, the old value is replaced.

This method is defined as:

return (String)put(new Attributes.Name(name), value);

Parameters
`name`	String!: the attribute name as a string
`value`	String!: the attribute value

Return
`String!`	the previous value of the attribute, or null if none

Exceptions
`java.lang.IllegalArgumentException`	if the attribute name is invalid

remove

Added in API level 1

open fun remove(key: Any!): Any?

Removes the attribute with the specified name (key) from this Map. Returns the previous attribute value, or null if none.

Parameters
`key`	Any!: key whose mapping is to be removed from the map
`name`	attribute name

Return
`Any?`	the previous value of the attribute, or null if none

Exceptions
`java.lang.UnsupportedOperationException`	if the `remove` operation is not supported by this map
`java.lang.ClassCastException`	if the key is of an inappropriate type for this map (java.util.Collection#)
`java.lang.NullPointerException`	if the specified key is null and this map does not permit null keys (java.util.Collection#)

Properties

entries

Added in API level 1

open val entries: MutableSet<MutableEntry<Any!, Any!>>

Returns a Collection view of the attribute name-value mappings contained in this Map.

Return
`MutableSet<MutableEntry<Any!, Any!>>`	a set view of the mappings contained in this map

keys

Added in API level 1

open val keys: MutableSet<Any!>

Returns a Set view of the attribute names (keys) contained in this Map.

Return
`MutableSet<Any!>`	a set view of the keys contained in this map

map

Added in API level 1

protected var map: MutableMap<Any!, Any!>!

The attribute name-value mappings.

size

Added in API level 1

open val size: Int

Returns the number of attributes in this Map.

Return
`Int`	the number of key-value mappings in this map

values

Added in API level 1

open val values: MutableCollection<Any!>

Returns a Collection view of the attribute values contained in this Map.

Return
`MutableCollection<Any!>`	a collection view of the values contained in this map