Struct mlua::String [−][src]
pub struct String<'lua>(_);
Expand description
Handle to an internal Lua string.
Unlike Rust strings, Lua strings may not be valid UTF-8.
Implementations
Get a &str
slice if the Lua string is valid UTF-8.
Examples
let globals = lua.globals(); let version: String = globals.get("_VERSION")?; assert!(version.to_str()?.contains("Lua")); let non_utf8: String = lua.load(r#" "test\255" "#).eval()?; assert!(non_utf8.to_str().is_err());
Converts this string to a Cow<str>
.
Any non-Unicode sequences are replaced with U+FFFD REPLACEMENT CHARACTER
.
Examples
let lua = Lua::new(); let s = lua.create_string(b"test\xff")?; assert_eq!(s.to_string_lossy(), "test\u{fffd}");
Get the bytes that make up this string.
The returned slice will not contain the terminating nul byte, but will contain any nul bytes embedded into the Lua string.
Examples
let non_utf8: String = lua.load(r#" "test\255" "#).eval()?; assert!(non_utf8.to_str().is_err()); // oh no :( assert_eq!(non_utf8.as_bytes(), &b"test\xff"[..]);
Trait Implementations
Auto Trait Implementations
impl<'lua> !RefUnwindSafe for String<'lua>
impl<'lua> !UnwindSafe for String<'lua>
Blanket Implementations
Mutably borrows from an owned value. Read more