• balsoft@lemmy.ml
    link
    fedilink
    arrow-up
    5
    ·
    edit-2
    1 day ago

    Rust does not have exceptions. You never have to try/catch. Functions usually encode the possible failures in their types, so you’d have something like this C++ snippet:

    struct HttpError {
      std::string message;
      int responseCode;
    }
    
    struct FsError {
      std::string message;
    }
    
    typedef std::variant<HttpError, IoError> FileDownloadError;
    
    std::variant<std::filesystem::path, FileDownloadError> downloadFile(std::string url) { /* ... */ }
    

    And then the caller of downloadFile has to decide what to do if it returns an error:

    auto res = std::visit(overloaded {
    	[](FileDownloadError e) { /* ignore error, or handle it somehow, and return a new path */ },
    	[](std::filesystem::path p) { return p; }
    }, downloadFile(url));
    
    /* res is guaranteed to be a valid std::filesystem::path, you don't have to care about errors from downloadFile anymore */
    

    However, Rust makes this whole thing a lot easier, by providing syntax sugar, and there are helper libraries that reduce the boilerplate. You usually end up with something like

    #[derive(Error, Debug)]
    enum FileDownloadError {
      #[error("HTTP request failed")]
      HttpError(http::status::StatusCode),
      #[error("Filesystem error: {0}")
      FSError(#[from] std::io::Error),
    }
    
    fn download_file(String url) -> Result<Path, FileDownloadError> {/* ... */}
    

    (notice the #[from], which forwards the error message etc from the std::io::Error type)

    The Result type is kind of like a std::variant with two template arguments, and, mostly by convention, the first one denotes the successful execution, while the second one is the error type. Result has a bunch of methods defined on it that help you with error handling.

    Consumer code is something like this:

    let res : Path = download_file(url).unwrap_or_else(|e| {
      /* Ignore the error or handle it. You have to return a new path here */
    });
    
    /* res is guaranteed to be a valid Path, you don't have to care about errors from download_file anymore */
    

    Or

    let res : Path = download_file(url)?;
    
    /* res is guaranteed to be a valid Path, you don't have to care about errors from download_file anymore */
    

    Which will just forward the error to your caller (but your function has to return Result as well), or proceed with the execution if the function succeeded.

    Finally, download_file(url).unwrap() is if you can neither ignore, nor handle, nor pass the error to the caller. It will abort if the function fails in any way, and there’s no (practical) way to catch that abort.