Lær at programmere i Rust · Lektion

pub og synlighed

Styr adgang

Lektion 2 af 413 trin

pub og synlighed er en gratis Lær at programmere i Rust-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Lær at programmere i Rust, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Lær at programmere i Rust-kurset indeholder 4 lektioner i alt.

Private som standard

I Rust er alt i et modul privat som standard. Andre moduler kan ikke se det, medmindre du aktivt gør det tilgængeligt med pub.

Denne sikre standard holder implementeringsdetaljer skjult, indtil du bevidst eksponerer dem.

pub-funktioner

Når du markerer en funktion med pub, kan den kaldes uden for sit modul. Uden det kan kaldet ikke kompileres.

mod math {
    pub fn square(x: i32) -> i32 {
        x * x
    }
}

fn main() {
    println!("{}", math::square(5));
}

Private hjælpefunktioner forbliver skjulte

Du kan holde interne hjælpefunktioner private, samtidig med at du eksponerer en offentlig API. Den offentlige funktion må gerne kalde den private, men det kan brugere udenfor ikke.

mod math {
    fn double(x: i32) -> i32 { x * 2 }
    pub fn quadruple(x: i32) -> i32 { double(double(x)) }
}

fn main() {
    println!("{}", math::quadruple(3));
}

pub-strukturer skjuler felter

Når du gør en struct til pub, eksponerer du typen, men dens felter forbliver private, medmindre hvert felt også markeres med pub.

Det giver dig kontrol over, hvordan structen oprettes og ændres.

mod model {
    pub struct User {
        pub name: String,
        age: u32,
    }
    impl User {
        pub fn new(name: String, age: u32) -> User {
            User { name, age }
        }
        pub fn age(&self) -> u32 { self.age }
    }
}

fn main() {
    let u = model::User::new(String::from("Sam"), 28);
    println!("{} is {}", u.name, u.age());
}

Hvorfor skjule felter?

Private felter håndhæver invariansbetingelser. Kaldere skal bruge din konstruktør og dine metoder, så du kan validere input og senere ændre det interne layout uden at bryde brugernes kode.

pub-enumer eksponerer alt

I modsætning til structs gør en pub-enum automatisk alle sine varianter offentlige. Varianter har ingen separat synlighed.

mod traffic {
    pub enum Light {
        Red,
        Yellow,
        Green,
    }
}

fn main() {
    let l = traffic::Light::Green;
    let go = matches!(l, traffic::Light::Green);
    println!("go = {}", go);
}

pub(crate): i hele craten

pub(crate) gør et element synligt overalt i den samme crate, men ikke for eksterne crates, der afhænger af din.

Det er perfekt til interne API'er, der deles på tværs af moduler.

mod config {
    pub(crate) fn default_port() -> u16 {
        8080
    }
}

fn main() {
    println!("{}", config::default_port());
}

pub(super): kun forælderen

pub(super) eksponerer kun et element for forældremodulet. Det er en smallere adgang end fuld pub.

mod outer {
    pub fn run() {
        inner::helper();
    }
    mod inner {
        pub(super) fn helper() {
            println!("visible to parent only");
        }
    }
}

fn main() {
    outer::run();
}

Geneksport med pub use

pub use geneksporterer et element, så kaldere kan nå det via en kortere eller mere praktisk sti. Det hjælper med at forme en ren offentlig API.

mod deep {
    pub mod nested {
        pub fn ping() {
            println!("pong");
        }
    }
    pub use nested::ping;
}

fn main() {
    deep::ping();
}

Design af en offentlig API

Eksponér den mindst mulige overflade, der løser opgaven. Hold hjælpefunktioner private, skjul struct-felter bag metoder, og brug pub(crate) til intern deling.

En stram API er lettere at videreudvikle uden at bryde brugernes kode.

Oversigt over synlighedsniveauer

Fra mest til mindst restriktivt:

  • standard (privat for modulet)
  • pub(super) — synlig for forælderen
  • pub(crate) — synlig i hele craten
  • pub — synlig overalt

Hurtigt tjek

Test, om du har forstået synlighed.

Opsummering

Du har lært at styre adgang:

  • Elementer er private som standard; pub eksponerer dem
  • pub-structs holder felter private, medmindre hvert felt er pub
  • pub-enums eksponerer alle varianter
  • pub(crate) og pub(super) giver mere finmasket kontrol
  • pub use geneksporterer elementer for at forme en ren API
Gratis at komme i gang

Lær Rust med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
39
Lektioner
144

Ofte stillede spørgsmål

Er lektionen “pub og synlighed” gratis?

Ja — alle 3 lektioner i læringssporet Lær at programmere i Rust, inklusive “pub og synlighed”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Lær at programmere i Rust-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “pub og synlighed”?

Styr adgang Du øver dig i Lær at programmere i Rust med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Lær at programmere i Rust?

Der kræves ingen tidligere erfaring. Lær at programmere i Rust på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “pub og synlighed”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Lær at programmere i Rust-lektion?

Ja. Alle Lær at programmere i Rust-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Moduler og mod
  2. pub og synlighed
  3. use og stier
  4. Crates og crate-roden
← Tilbage til Lær at programmere i Rust