pub struct String<'lua>(_);
Expand description
Handle to an internal Lua string.
Unlike Rust strings, Lua strings may not be valid UTF-8.
Implementations§
source§impl<'lua> String<'lua>
impl<'lua> String<'lua>
sourcepub fn to_str(&self) -> Result<&str>
pub fn to_str(&self) -> Result<&str>
Get a &str
slice if the Lua string is valid UTF-8.
Examples
let globals = lua_context.globals();
let version: String = globals.get("_VERSION")?;
assert!(version.to_str().unwrap().contains("Lua"));
let non_utf8: String = lua_context.load(r#" "test\255" "#).eval()?;
assert!(non_utf8.to_str().is_err());
sourcepub fn as_bytes(&self) -> &[u8] ⓘ
pub fn as_bytes(&self) -> &[u8] ⓘ
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_context.load(r#" "test\255" "#).eval()?;
assert!(non_utf8.to_str().is_err()); // oh no :(
assert_eq!(non_utf8.as_bytes(), &b"test\xff"[..]);
sourcepub fn as_bytes_with_nul(&self) -> &[u8] ⓘ
pub fn as_bytes_with_nul(&self) -> &[u8] ⓘ
Get the bytes that make up this string, including the trailing nul byte.
Trait Implementations§
impl<'lua> Eq for String<'lua>
Auto Trait Implementations§
impl<'lua> !RefUnwindSafe for String<'lua>
impl<'lua> !Send for String<'lua>
impl<'lua> !Sync for String<'lua>
impl<'lua> Unpin for String<'lua>
impl<'lua> !UnwindSafe for String<'lua>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<'lua, T> FromLuaMulti<'lua> for Twhere
T: FromLua<'lua>,
impl<'lua, T> FromLuaMulti<'lua> for Twhere T: FromLua<'lua>,
source§fn from_lua_multi(
values: MultiValue<'lua>,
lua: Context<'lua>
) -> Result<T, Error>
fn from_lua_multi( values: MultiValue<'lua>, lua: Context<'lua> ) -> Result<T, Error>
Performs the conversion. Read more
source§impl<'lua, T> ToLuaMulti<'lua> for Twhere
T: ToLua<'lua>,
impl<'lua, T> ToLuaMulti<'lua> for Twhere T: ToLua<'lua>,
source§fn to_lua_multi(self, lua: Context<'lua>) -> Result<MultiValue<'lua>, Error>
fn to_lua_multi(self, lua: Context<'lua>) -> Result<MultiValue<'lua>, Error>
Performs the conversion.