elaborate 1.2.0

Wrappers for standard library functions and types to produce more elaborate error messages
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

// This file was automatically generated by `elaborate`.
// https://github.com/trailofbits/elaborate

#[allow(unused_imports)]
use anyhow::Context;



pub trait OsStrContext {
/// Yields a <code>&[str]</code> slice if the `OsStr` is valid Unicode.
/// 
/// This conversion may entail doing a check for UTF-8 validity.
/// 
/// # Examples
/// 
/// ```
/// use std::ffi::OsStr;
/// 
/// let os_str = OsStr::new("foo");
/// assert_eq!(os_str.to_str(), Some("foo"));
/// ```
fn to_str_wc ( & self ) -> crate :: rewrite_output_type ! ( core :: option :: Option < & str > );
}
impl OsStrContext for std :: ffi :: OsStr {
fn to_str_wc ( & self ) -> crate :: rewrite_output_type ! ( core :: option :: Option < & str > ) {
    std :: ffi :: OsStr :: to_str(self)
        .with_context(|| crate::call_failed!(Some(self), "to_str"))
}
}
pub trait OsStringContext {
/// Tries to reserve capacity for at least `additional` more length units
/// in the given `OsString`. The string may reserve more space to speculatively avoid
/// frequent reallocations. After calling `try_reserve`, capacity will be
/// greater than or equal to `self.len() + additional` if it returns `Ok(())`.
/// Does nothing if capacity is already sufficient. This method preserves
/// the contents even if an error occurs.
/// 
/// See the main `OsString` documentation information about encoding and capacity units.
/// 
/// # Errors
/// 
/// If the capacity overflows, or the allocator reports a failure, then an error
/// is returned.
/// 
/// # Examples
/// 
/// ```
/// use std::ffi::{OsStr, OsString};
/// use std::collections::TryReserveError;
/// 
/// fn process_data(data: &str) -> Result<OsString, TryReserveError> {
///     let mut s = OsString::new();
/// 
///     // Pre-reserve the memory, exiting if we can't
///     s.try_reserve(OsStr::new(data).len())?;
/// 
///     // Now we know this can't OOM in the middle of our complex work
///     s.push(data);
/// 
///     Ok(s)
/// }
/// # process_data("123").expect("why is the test harness OOMing on 3 bytes?");
/// ```
fn try_reserve_wc ( & mut self , additional : usize ) -> crate :: rewrite_output_type ! ( core :: result :: Result < ( ) , std :: collections :: TryReserveError > );
/// Tries to reserve the minimum capacity for at least `additional`
/// more length units in the given `OsString`. After calling
/// `try_reserve_exact`, capacity will be greater than or equal to
/// `self.len() + additional` if it returns `Ok(())`.
/// Does nothing if the capacity is already sufficient.
/// 
/// Note that the allocator may give the `OsString` more space than it
/// requests. Therefore, capacity can not be relied upon to be precisely
/// minimal. Prefer [`try_reserve`] if future insertions are expected.
/// 
/// [`try_reserve`]: OsString::try_reserve
/// 
/// See the main `OsString` documentation information about encoding and capacity units.
/// 
/// # Errors
/// 
/// If the capacity overflows, or the allocator reports a failure, then an error
/// is returned.
/// 
/// # Examples
/// 
/// ```
/// use std::ffi::{OsStr, OsString};
/// use std::collections::TryReserveError;
/// 
/// fn process_data(data: &str) -> Result<OsString, TryReserveError> {
///     let mut s = OsString::new();
/// 
///     // Pre-reserve the memory, exiting if we can't
///     s.try_reserve_exact(OsStr::new(data).len())?;
/// 
///     // Now we know this can't OOM in the middle of our complex work
///     s.push(data);
/// 
///     Ok(s)
/// }
/// # process_data("123").expect("why is the test harness OOMing on 3 bytes?");
/// ```
fn try_reserve_exact_wc ( & mut self , additional : usize ) -> crate :: rewrite_output_type ! ( core :: result :: Result < ( ) , std :: collections :: TryReserveError > );
}
impl OsStringContext for std :: ffi :: OsString {
fn try_reserve_wc ( & mut self , additional : usize ) -> crate :: rewrite_output_type ! ( core :: result :: Result < ( ) , std :: collections :: TryReserveError > ) {
    std :: ffi :: OsString :: try_reserve(self, additional)
        .with_context(|| crate::call_failed!(Some(self), "try_reserve", additional))
}
fn try_reserve_exact_wc ( & mut self , additional : usize ) -> crate :: rewrite_output_type ! ( core :: result :: Result < ( ) , std :: collections :: TryReserveError > ) {
    std :: ffi :: OsString :: try_reserve_exact(self, additional)
        .with_context(|| crate::call_failed!(Some(self), "try_reserve_exact", additional))
}
}