try (dépréciée) |
Essai |
|---|---|
| Rust | |
Syntaxe
|
macro_rules! try { ($expr:expr $(,)?) => { ... }; } |
Description
Cette macro permettait de déballer un résultat (Result) ou de propager l'erreur automatiquement, mais elle est maintenant remplacée par l'opérateur ?.
Remarques
Obsolète depuis la version 1.39.0 : utilisez plutôt l'opérateur «?»
Permet de décompresser un résultat ou propage son erreur.
L'opérateur ? a été ajouté pour remplacer try! et doit être utilisé à la place. De plus, try est un mot réservé en Rust 2018 ; si vous devez l'utiliser, vous devrez donc utiliser la syntaxe d'identifiant brut : r#try.
try! correspond au résultat donné. Dans le cas de la variante Ok, l'expression a la valeur de la valeur encapsulée.
Dans le cas de la variante Err, l'erreur interne est récupérée. try! effectue ensuite la conversion avec From. Cela permet une conversion automatique entre les erreurs spécialisées et les erreurs plus générales. L'erreur résultante est alors immédiatement renvoyée.
En raison du retour anticipé, try! ne peut être utilisé que dans les fonctions renvoyant un résultat.
Exemples
- use std::io;
- use std::fs::File;
- use std::io::prelude::*;
-
- enum MyError {
- FileWriteError
- }
-
- impl From<io::Error> for MyError {
- fn from(e: io::Error) -> MyError {
- MyError::FileWriteError
- }
- }
-
- // The preferred method of quick returning Errors
- fn write_to_file_question() -> Result<(), MyError> {
- let mut file = File::create("my_best_friends.txt")?;
- file.write_all(b"Voici une liste de mes meilleurs amis.")?;
- Ok(())
- }
-
- // The previous method of quick returning Errors
- fn write_to_file_using_try() -> Result<(), MyError> {
- let mut file = r#try!(File::create("my_best_friends.txt"));
- r#try!(file.write_all(b"Voici une liste de mes meilleurs amis."));
- Ok(())
- }
-
- // This is equivalent to:
- fn write_to_file_using_match() -> Result<(), MyError> {
- let mut file = r#try!(File::create("my_best_friends.txt"));
- match file.write_all(b"Voici une liste de mes meilleurs amis.") {
- Ok(v) => v,
- Err(e) => return Err(From::from(e)),
- }
- Ok(())
- }