Видимост
По подразбиране единиците в един модул имат частна видмост, но това може да се
промени чрез използване на променителя1 pub. Само общите
единици2 (обозначени с pub) могат да се достъпят отвън – от код, който
е извън обхвата на модула.
// Модул с име `my_mod` mod my_mod { // Единиците в модулите имат частна видимост по подразбиране // (не са видими отвън). fn private_function() { println!("извикахме `my_mod::private_function()`"); } // Използваме променителя `pub` да отменим подразбираната видимост. pub fn function() { println!("извикахме `my_mod::function()`"); } // Единиците могат да достъпват други единици в същия модул, дори частни. pub fn indirect_access() { print!("извикахме `my_mod::indirect_access()`, която извиква\n> "); private_function(); } // Модулите могат също да бъдат вложени pub mod nested { pub fn function() { println!("извикахме `my_mod::nested::function()`"); } #[allow(dead_code)] fn private_function() { println!("извикахме `my_mod::nested::private_function()`"); } // Функции, обявени чрез изписването `pub(in път)`, са видими само в // подадения път. `път` трябва да бъде родителски или прародителски модул pub(in crate::my_mod) fn public_function_in_my_mod() { print!("извикахме `my_mod::nested::public_function_in_my_mod()`, \ която извика\n> "); public_function_in_nested(); } // Функции, обявени чрез изписването `pub(self)`, са видими само // в текущия модул, което е същото като да ги оставим частни. pub(self) fn public_function_in_nested() { println!("извикахме `my_mod::nested::public_function_in_nested()`"); } // Функции, обявени чрез изписването `pub(super)`, // са видими само в родителския модул. pub(super) fn public_function_in_super_mod() { println!("извикахме \ `my_mod::nested::public_function_in_super_mod()`"); } } pub fn call_public_function_in_my_mod() { print!("извикахме `my_mod::call_public_function_in_my_mod()`, \ която извиква\n> "); nested::public_function_in_my_mod(); print!("> "); nested::public_function_in_super_mod(); } // pub(crate) прави функциите видими само в текущия кош. pub(crate) fn public_function_in_crate() { println!("извикахме `my_mod::public_function_in_crate()`"); } // Вложените модули следват същите правила за видимост. mod private_nested { #[allow(dead_code)] pub fn function() { println!("извикахме `my_mod::private_nested::function()`"); } // Частните родителски единици продължават да ограничават видимостта на // дъщерните единици, дори да са обявени като видими в по-широк обхват. #[allow(dead_code)] pub(crate) fn restricted_function() { println!("извикахме \ `my_mod::private_nested::restricted_function()`"); } } } fn function() { println!("извикахме `function()`"); } fn main() { // Модулите ни позволяват да различаваме единици с еднакви имена. function(); my_mod::function(); // Общите единици, включително тези от вложените модули, могат да се // достъпят извън родителския модул. my_mod::indirect_access(); my_mod::nested::function(); my_mod::call_public_function_in_my_mod(); // Единиците, обявени чрез `pub(crate)`, могат да се извикат отвсякъде // в същия кош. my_mod::public_function_in_crate(); // Единиците, обявени чрез `pub(in path)`, могат да се извикват // само в указания модул // Грешка! Функцията `public_function_in_my_mod` е частна //my_mod::nested::public_function_in_my_mod(); // ЗАДАЧА ^ Разкоментирйте този ред // Частните единици за даден модул не могат да се достъпят пряко, // дори да са вложени в общ модул: // Грешка! `private_function` е частна //my_mod::private_function(); // ЗАДАЧА ^ Разкоментирйте този ред // Грешка! `private_function` е частна //my_mod::nested::private_function(); // ЗАДАЧА ^ Разкоментирйте този ред // Грешка! `private_nested` е частен модул //my_mod::private_nested::function(); // ЗАДАЧА ^ Разкоментирйте този ред // Грешка! `private_nested` е частен модул //my_mod::private_nested::restricted_function(); // ЗАДАЧА ^ Разкоментирйте този ред }
Б. пр.
1
променител (на видимостта) – (visibility) modifier
2
общи, общодостъпни единици (с обща видимост) – public items