Converting BStr/BString to std::String

[RAnders00]

I think this is a common use case. I can't find anything in the documentation. How is this done?

[RAnders00]

try_into()/String::try_from() should do the trick:

bstr/src/impls.rs

Lines 264 to 271 in ec2154a

	impl TryFrom<BString> for String {
	type Error = crate::FromUtf8Error;
	#[inline]
	fn try_from(s: BString) -> Result<String, crate::FromUtf8Error> {
	s.into_vec().into_string()
	}
	}

(Why is documentation not mentioning this? :( )

[BurntSushi]

The documentation does mention it: https://docs.rs/bstr/latest/bstr/struct.BString.html#impl-TryFrom%3CBString%3E-for-String

You need to know to look for TryFrom impls.

The prose docs do not include a refresher on TryFrom since it's a foundational trait in the standard library.

On top of that, there are ByteSlice::to_str and ByteVec::into_string methods that one can discover by looking at the methods on the core traits in this crate.

[BurntSushi]

A BStr can be converted to a &str via ByteSlice::to_str. It's one of the first methods listed on the trait. And if s is a &str, you can get a String via s.to_string().

A BString can be converted to a String via ByteVec::into_string.

There are also TryFrom impls for TryFrom<&BString> for &str and TryFrom<BString> for String. Analogously, there is also TryFrom<&BStr> for &str and TryFrom<&BStr> for String.