Colección de pares clave-valor donde las claves son del tipo de dato String
y los valores del tipo de la declaración T
. Las claves son únicas para cada valor.
METODOS PUBLICOS
Integer size()
Devuelve la cantidad total de pares en la colección.
Retorna |
|
Integer |
Cantidad de pares. |
T get(String clave)
Retorna el elemento asociado a la clave del parámetro. La colección y su tamaño no son modificados. En caso de no encontrar la clave se produce una excepción.
Argumentos |
|
clave |
String: clave de elemento deseado. |
Retorna |
|
T |
Elemento asociado. |
Excepciones |
|
CollectionKeyNotFound – Has not found a value for key ‘clave’. |
No se ha encontrado valor asociado a la clave ‘clave’. |
T get(String clave, T valorPorDefecto)
Retorna el elemento asociado a la clave del parámetro. La colección y su tamaño no son modificados. En caso de no encontrar la clave retorna el ‘valorPorDefecto’ pasado como argumento.
Argumentos |
|
clave |
String: clave de elemento deseado. |
Retorna |
|
T |
Elemento asociado a ‘clave’ o el ‘valorPorDefecto’ pasado como argumento. |
void remove(String clave)
Elimina el elemento asociado a la clave parámetro. Luego de remover el elemento el tamaño de la colección disminuye en uno. No efectua modificación alguna en caso de no encontrar la clave.
Argumentos |
|
clave |
String: clave de elemento que se desea remover. |
void removeAll()
Elimina todos los elementos del mapa, el tamaño del mapa queda en cero.
Map<T> clone()
Crea una nueva instancia de un mapa con misma cantidad de elementos, cada uno de sus elementos y claves son nuevas referencias a copias fieles de los elementos del mapa original.
Retorna |
|
Map |
Nueva instancia con contenido idéntico al array original. |
Bool hasKey(String clave)
Devuelve true si encuentra el elemento asociado a la clave parámetro, false caso contrario.
Retorna |
|
Bool |
Existencia de elemento para clave. |
Array<String> keys()
Devuelve un array con todas las claves de los pares que contiene.
Retorna |
|
Array |
Lista de claves. |
Array<T> values()
Devuelve un array con todos los valores de los pares que contiene.
Retorna |
|
Array |
Lista de elementos. |
void set(String clave, T elemento)
Agrega el elemento parámetro al mapa y lo asocia a la clave. Si la clave ya tenía un elemento asociado lo reemplaza.
Argumentos |
|
clave |
String: clave para reemplazar o agregar. |
elemento |
T: elemento. |
Excepciones |
|
TypeMismatchInAddInCollection – Type mismatch adding an element value of different type in a collection. |
El elemento que se desea agregar no es del tipo T de la colección. |