Броители
Ключовата дума enum1 позволява създаването на тип, който може да
представлява един от няколко различни варианта. Всеки вариант, който може да
бъде действителна2 структура, може да бъде действителен и в броител
(enum).
// Създаваме `enum`, за да определим някакво събитие в уеб. // Забележете как името и типът на данните заедно определят варианта: // `PageLoad != PageUnload` и `KeyPress(char) != Paste(String)`. // Всеки вариант е различен и независим. enum WebEvent { // Всеки вариант на `enum` може да бъде: // празна единица `unit`; PageLoad, PageUnload, // разнородна поредица `tuple`; KeyPress(char), Paste(String), // или C-образна стурктура (като тези в езика C). Click { x: i64, y: i64 }, } // Функция, която приема броител `WebEvent` като аргумент // и не връща нищо. fn inspect(event: WebEvent) { match event { WebEvent::PageLoad => println!("заредихте страницата"), WebEvent::PageUnload => println!("напуснахте страницата"), // Разлагаме (изваждаме) `c` от варианта на `enum`. WebEvent::KeyPress(c) => println!("натиснахте '{}'.", c), WebEvent::Paste(s) => println!("поставихте \"{}\".", s), // Разлагаме `Click` на `x` и `y`. WebEvent::Click { x, y } => { println!("натиснахте място с координати x={}, y={}.", x, y); }, } } fn main() { let pressed = WebEvent::KeyPress('x'); // `to_owned()` създава *притежаван* `String` от низов отрязък. let pasted = WebEvent::Paste("my text".to_owned()); let click = WebEvent::Click { x: 20, y: 80 }; let load = WebEvent::PageLoad; let unload = WebEvent::PageUnload; inspect(pressed); inspect(pasted); inspect(click); inspect(load); inspect(unload); }
Прякори на типове
Ако ползвате прякор3 на тип, можете да се обръщате към всеки вариант на броителя чрез неговия прякор. Това може да се окаже полезно, ако името на броителя е твърде дълго или твърде общо и искате да го промените.
enum VeryVerboseEnumOfThingsToDoWithNumbers { Add, Subtract, } // Създаваме прякор на типа type Operations = VeryVerboseEnumOfThingsToDoWithNumbers; fn main() { // Можем да достигаме до всеки вариант на броителя чрез прякора му. // По-кратко и удобно е. let x = Operations::Add; }
Най-често ще виждате използването на прякори в блоковете за осъществяване
impl, където се ползва прякорът Self.
enum VeryVerboseEnumOfThingsToDoWithNumbers { Add, Subtract, } impl VeryVerboseEnumOfThingsToDoWithNumbers { fn run(&self, x: i32, y: i32) -> i32 { match self { Self::Add => x + y, Self::Subtract => x - y, } } }
За да научите повече за броителите и типовите прякори, може да прочетете отчета за стабилизация. Оттогава е стабилна тази способност4 на Ръждьо.
Вижте също:
match, fn и String, "Type alias enum variants" RFC
Б. пр.
броител – enum. От enumerator – буквално „изброител”
действителен – valid
способност, възможност – feature