Add doc example for CStr::to_str.

This commit is contained in:
Corey Farwell 2017-06-18 16:12:39 -07:00
parent 0962394b84
commit e52d2f2ad0

View file

@ -894,6 +894,15 @@ pub fn to_bytes_with_nul(&self) -> &[u8] {
/// > check whenever this method is called.
///
/// [`&str`]: ../primitive.str.html
///
/// # Examples
///
/// ```
/// use std::ffi::CStr;
///
/// let c_str = CStr::from_bytes_with_nul(b"foo\0").unwrap();
/// assert_eq!(c_str.to_str(), Ok("foo"));
/// ```
#[stable(feature = "cstr_to_str", since = "1.4.0")]
pub fn to_str(&self) -> Result<&str, str::Utf8Error> {
// NB: When CStr is changed to perform the length check in .to_bytes()