HOWTO · Bash
Matriz asociativa Bash
Este tutorial demuestra cómo crear una matriz asociativa en Bash.
En esta página
Esta guía explica cómo crear y usar una matriz asociativa de Bash: asignar valores a claves de texto, consultar entradas, recorrer claves y valores, agregar o actualizar entradas y eliminar una clave. Los ejemplos son fragmentos independientes que puedes ejecutar en una shell de Bash.
Consultar la versión de Bash y entender las matrices asociativas
Una matriz asociativa relaciona claves de texto con valores. A diferencia de una matriz indexada, sus elementos se seleccionan por nombres, como One, y no por posiciones numéricas. El comando integrado declare de Bash crea la matriz. Para consultar la versión activa de Bash, ejecuta:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
bash --version
Este comando informa la versión; esa información por sí sola no verifica la compatibilidad con la función en un contexto de shell determinado. Ejecuta los ejemplos en el entorno de Bash donde se utilizará el script.
Declarar una matriz asociativa
Usa declare -A para crear una matriz asociativa antes de asignarle claves. Pon entre comillas los valores que contengan espacios y también las expansiones cuando pases el contenido de la matriz a comandos, para que cada valor siga siendo un argumento independiente.
Ejecuta este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
declare -A DemoArray
DemoArray[One]="Delftstack1"
DemoArray[Two]="Delftstack2"
printf '%s\n' "${DemoArray[One]}" "${DemoArray[Two]}"
También puedes inicializar las claves y los valores al declarar la matriz. Mantén cada asignación de clave y valor dentro de los paréntesis:
declare -A DemoArray1=( [One]="Delftstack1" [Two]="Delftstack2" [Three]="Delftstack3" )
printf '%s\n' "${DemoArray1[One]}" "${DemoArray1[Two]}" "${DemoArray1[Three]}"
Leer claves y valores
Usa ${DemoArray[One]} para obtener el valor asociado a una clave. La expansión [@] selecciona todos los valores, mientras que ${!DemoArray[@]} selecciona todas las claves. Al poner estas expansiones entre comillas, los valores que contienen espacios en blanco se conservan como elementos separados dentro de un bucle. Un bucle de pares clave-valor puede consultar cada clave actual para imprimir el valor asociado:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
declare -A DemoArray=( [One]="Delftstack1" [Two]="Delftstack2" [Three]="Delftstack3" )
printf 'One: %s\n' "${DemoArray[One]}"
for key in "${!DemoArray[@]}"; do
printf 'key: %s\n' "$key"
done
for value in "${DemoArray[@]}"; do
printf 'value: %s\n' "$value"
done
for key in "${!DemoArray[@]}"; do
printf '%s => %s\n' "$key" "${DemoArray[$key]}"
done
El orden de recorrido de una matriz asociativa no está especificado. No des por sentado que las claves o los valores aparecerán en el mismo orden en ejecuciones distintas; usa cada clave para obtener el valor correspondiente en vez de emparejar por posición listas separadas de claves y valores. Si el programa necesita un orden de presentación estable, ordena las claves por separado antes de imprimirlas.
Agregar o actualizar entradas
Asignar un valor a una clave la agrega si es nueva y reemplaza su valor si ya existe. La asignación compuesta += puede agregar uno o varios pares de clave y valor a una matriz asociativa existente. El ejemplo muestra ambas operaciones; la secuencia impresa no garantiza el orden de recorrido:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
declare -A DemoArray=( [One]="Delftstack1" [Two]="Delftstack2" )
DemoArray+=([Three]="Delftstack3")
DemoArray[Two]="Updated value"
for key in "${!DemoArray[@]}"; do
printf '%s => %s\n' "$key" "${DemoArray[$key]}"
done
Usa un valor entre comillas cuando contenga espacios. Asignar un valor a una clave existente no crea una segunda copia de esa clave: cambia el valor asociado a ella.
Eliminar entradas
Pasa el elemento de la matriz a unset para eliminar una clave y su valor. Pon entre comillas la expresión del subíndice para que la shell la pase al comando integrado como un solo argumento. Las demás entradas siguen disponibles y, al consultar una clave eliminada, ya no se obtiene su valor anterior.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
declare -A DemoArray=( [One]="Delftstack1" [Two]="Delftstack2" [Three]="Delftstack3" )
unset 'DemoArray[Two]'
for key in "${!DemoArray[@]}"; do
printf '%s => %s\n' "$key" "${DemoArray[$key]}"
done
Recorre las claves restantes para inspeccionar la matriz después de eliminar la entrada. Como su orden no está especificado, busca una clave concreta por nombre cuando la siguiente operación dependa de que esté presente.