NulError in alloc::ffi - Rust (original) (raw)
Struct NulError
1.64.0 · Source
pub struct NulError(/* private fields */);Expand description
An error indicating that an interior nul byte was found.
While Rust strings may contain nul bytes in the middle, C strings can’t, as that byte would effectively truncate the string.
This error is created by the new method onCString. See its documentation for more.
§Examples
use std::ffi::{CString, NulError};
let _: NulError = CString::new(b"f\0oo".to_vec()).unwrap_err();1.0.0 · Source
Returns the position of the nul byte in the slice that causedCString::new to fail.
§Examples
use std::ffi::CString;
let nul_error = CString::new("foo\0bar").unwrap_err();
assert_eq!(nul_error.nul_position(), 3);
let nul_error = CString::new("foo bar\0").unwrap_err();
assert_eq!(nul_error.nul_position(), 7);1.0.0 · Source
Consumes this error, returning the underlying vector of bytes which generated the error in the first place.
§Examples
use std::ffi::CString;
let nul_error = CString::new("foo\0bar").unwrap_err();
assert_eq!(nul_error.into_vec(), b"foo\0bar");1.30.0§
Returns the lower-level source of this error, if any. Read more
1.0.0§
👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0§
👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
🔬This is a nightly-only experimental API. (error_generic_member_access #99301)
Provides type-based access to context intended for error reports. Read more
Tests for self and other values to be equal, and is used by ==.
1.0.0§
Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬This is a nightly-only experimental API. (clone_to_uninit #126799)
Performs copy-assignment from self to dest. Read more
Returns the argument unchanged.
Calls U::from(self).
That is, this conversion is whatever the implementation of[From](../../core/convert/trait.From.html "trait core::convert::From")<T> for U chooses to do.
The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.