Compilación condicional con el atributo cfg de Rust

RustRustBeginner
Practicar Ahora

This tutorial is from open-source community. Access the source code

💡 Este tutorial está traducido por IA desde la versión en inglés. Para ver la versión original, puedes hacer clic aquí

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.


Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL rust(("Rust")) -.-> rust/MemorySafetyandManagementGroup(["Memory Safety and Management"]) rust(("Rust")) -.-> rust/DataTypesGroup(["Data Types"]) rust(("Rust")) -.-> rust/FunctionsandClosuresGroup(["Functions and Closures"]) rust/DataTypesGroup -.-> rust/string_type("String Type") rust/FunctionsandClosuresGroup -.-> rust/function_syntax("Function Syntax") rust/FunctionsandClosuresGroup -.-> rust/expressions_statements("Expressions and Statements") rust/MemorySafetyandManagementGroup -.-> rust/lifetime_specifiers("Lifetime Specifiers") subgraph Lab Skills rust/string_type -.-> lab-99342{{"Compilación condicional con el atributo cfg de Rust"}} rust/function_syntax -.-> lab-99342{{"Compilación condicional con el atributo cfg de Rust"}} rust/expressions_statements -.-> lab-99342{{"Compilación condicional con el atributo cfg de Rust"}} rust/lifetime_specifiers -.-> lab-99342{{"Compilación condicional con el atributo cfg de Rust"}} end

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.