% Enumeraciones

Una enumeración (enum) en Rust es un tipo que representa data que puede ser una de un conjunto de variantes posible:

enum Mensaje {
    Salir,
    CambiarColor(i32, i32, i32),
    Mover { x: i32, y: i32 },
    Escribir(String),
}

Cada variante puede opcionalmente tener data asociada. La sintaxis para la definición de variantes es semejante a la sintaxis usada para definir estructuras (structs): puedes tener variantes sin datos (como las estructuras tipo-unitario), variantes con data nombrada, y variantes con data sin nombres (como tupla estructuras). Sin embargo, a diferencia de las definiciones de estructuras, un enum es un único tipo. Un valor de un enum puede coincidir con cualquiera de las variantes. Por esta razón, un enum es denominado algunas veces un ‘tipo suma’ (‘sum type’): el conjunto de valores posibles del enum es la suma de los conjuntos de valores posibles para cada variante.

Utilizamos la sintaxis :: para hacer uso de cada variante: las variantes están dentro del ámbito del enum. Lo que hace que lo siguiente sea valido:

# enum Mensaje {
#     Mover { x: i32, y: i32 },
# }
let x: Mensaje = Mensaje::Mover { x: 3, y: 4 };

enum TurnoJuegoMesa {
    Mover { celdas: i32 },
    Pasar,
}

let y: TurnoJuegoMesa = TurnoJuegoMesa::Mover { celdas: 1 };

Ambas variantes poseen el nombre Mover, pero debido a que su ámbito es dentro del nombre del enum, ambas pueden ser usadas sin conflicto.

Un valor de un tipo enum contiene información acerca de cual variante es, en adición a cualquier data asociada con dicha variante. Esto es algunas veces denominado ‘union etiquetada’ (‘tagged union’), puesto a que la data incluye una ‘etiqueta’ (‘tag’) que indica que tipo es. El compilador usa esta información para asegurarse que estemos accediendo a la data en el enum de manera segura. Por ejemplo, no puedes simplemente tratar de destructurar un valor como si este fuere una de las posibles variantes:

fn procesar_cambio_color(msj: Mensaje) {
    let Mensaje::CambiarColor(r, v, a) = msj; // compile-time error
}

No soportar este tipo de operaciones puede lucir un poco limitante, pero es una limitación que podemos superar. Existen dos maneras, implementando la igualdad por nuestra cuenta, o a través de el pattern matching con expresiones match, que aprenderás en la siguiente sección. Todavía no sabemos lo suficiente de Rust para implementar la igualdad por nuestra cuenta, pero lo veremos en la sección traits.

Constructores como funciones

Un constructor de un enum puede ser también usado como una función. Por ejemplo:

# enum Mensaje {
# Escribir(String),
# }
let m = Mensaje::Escribir("Hola, mundo".to_string());

Es lo mismo que

# enum Mensaje {
# Escribir(String),
# }
fn foo(x: String) -> Mensaje {
    Mensaje::Escribir(x)
}

let x = foo("Hola, mundo".to_string());

Esto no es inmediatamente util para nosotros, pero cuando lleguemos a los closures, hablaremos acerca de pasar funciones como argumentos a otras funciones. Por ejemplo, con los iteradores, podemos convertir un vector de Strings en un vector de Message::Escribirs:

# enum Mensaje {
# Escribir(String),
# }

let v = vec!["Hola".to_string(), "Mundo".to_string()];

let v1: Vec<Mensaje> = v.into_iter().map(Mensaje::Escribir).collect();