Compilación condicional con el atributo cfg de Rust

Introducción

En este laboratorio, aprenderá sobre el atributo cfg y la macro cfg! en Rust, que permiten realizar comprobaciones condicionales en la configuración y la evaluación, respectivamente. El atributo cfg habilita la compilación condicional, mientras que la macro cfg! evalúa a verdadero o falso en tiempo de ejecución. Los bloques de código que usan cfg! deben ser válidos independientemente del resultado de la evaluación, a diferencia de #[cfg] que puede eliminar código.

Nota: Si el laboratorio no especifica un nombre de archivo, puede usar cualquier nombre de archivo que desee. Por ejemplo, puede usar main.rs, compilarlo y ejecutarlo con rustc main.rs &&./main.

cfg

Es posible realizar comprobaciones condicionales de configuración a través de dos operadores diferentes:

• el atributo cfg: #[cfg(...)] en la posición del atributo
• la macro cfg!: cfg!(...) en expresiones booleanas

Mientras que el primero habilita la compilación condicional, el segundo se evalúa condicionalmente a los literales true o false, lo que permite realizar comprobaciones en tiempo de ejecución. Ambos utilizan la misma sintaxis de argumentos.

A diferencia de #[cfg], cfg! no elimina ningún código y solo se evalúa a true o false. Por ejemplo, todos los bloques en una expresión if/else deben ser válidos cuando cfg! se utiliza para la condición, independientemente de lo que esté evaluando cfg!.

// Esta función solo se compila si el sistema operativo destino es linux
#[cfg(target_os = "linux")]
fn are_you_on_linux() {
    println!("You are running linux!");
}

// Y esta función solo se compila si el sistema operativo destino *no* es linux
#[cfg(not(target_os = "linux"))]
fn are_you_on_linux() {
    println!("You are *not* running linux!");
}

fn main() {
    are_you_on_linux();

    println!("Are you sure?");
    if cfg!(target_os = "linux") {
        println!("Yes. It's definitely linux!");
    } else {
        println!("Yes. It's definitely *not* linux!");
    }
}

Resumen

¡Felicidades! Has completado el laboratorio Cfg. Puedes practicar más laboratorios en LabEx para mejorar tus habilidades.