[−][src]Struct emacs::Value
A type that represents Lisp values.
Values of this type can be copied around, but are lifetime-bound to the Env
they come from.
They are also "proxy values" that are only useful when converted to Rust values, or used as arguments when calling back into the Lisp runtime.
Fields
env: &'e Env
Implementations
impl<'e> Value<'e>
[src]
pub fn is_not_nil(&self) -> bool
[src]
pub fn eq(&self, other: Value<'e>) -> bool
[src]
pub fn into_rust<T: FromLisp<'e>>(self) -> Result<T>
[src]
Converts this value into a Rust value of the given type.
pub fn into_ref<T: 'static>(self) -> Result<Ref<'e, T>>
[src]
pub fn into_ref_mut<T: 'static>(self) -> Result<RefMut<'e, T>>
[src]
pub unsafe fn get_mut<T: Transfer>(&mut self) -> Result<&mut T>
[src]
Returns a mutable reference to the underlying Rust data wrapped by this value.
Safety
There are several ways this can go wrong:
- Lisp code can pass the same object through 2 different values in an argument list.
- Rust code earlier in the call chain may have copied this value.
- Rust code later in the call chain may receive a copy of this value.
In general, it is better to wrap Rust data in RefCell
, Mutex
, or RwLock
guards, before
moving them to Lisp, and then only access them through these guards (which can be obtained
back through into_rust
). This method is for squeezing out the last bit of performance in
very rare situations.
pub fn car<T: FromLisp<'e>>(self) -> Result<T>
[src]
pub fn cdr<T: FromLisp<'e>>(self) -> Result<T>
[src]
impl<'e> Value<'e>
[src]
pub fn copy_string_contents(self, buffer: &mut [u8]) -> Result<&[u8]>
[src]
Copies the content of this Lisp string value to the given buffer as a null-terminated UTF-8 string. Returns the copied bytes, excluding the null terminator.
Signals an args-out-of-range
error if the buffer is too small.
impl<'e> Value<'e>
[src]
pub fn get_user_ptr(self) -> Result<*mut c_void>
[src]
Returns the raw pointer wrapped in this user-ptr
object.
In general, prefer the user-ptr
supported provided by the defun
attr macro. Use this
function only for special user-ptr
types, such as newtypes wrapping opaque pointers.
pub fn get_user_finalizer(self) -> Result<emacs_finalizer_function>
[src]
Returns the finalizer function associated with this user-ptr
object.
In general, prefer the user-ptr
supported provided by the defun
attr macro. Use this
function only for special user-ptr
types, such as newtypes wrapping opaque pointers.
impl<'e> Value<'e>
[src]
pub fn call<A>(self, args: A) -> Result<Value<'e>> where
A: IntoLispArgs<'e>,
[src]
A: IntoLispArgs<'e>,
Calls this value with the given arguments. An error is signaled if it is actually not a Lisp's callable.
args
should be an array/slice of Value
, or a tuple of different types, each implementing
IntoLisp
.
Examples
#[defun] fn mapc_enumerate_vec(function: Value, vector: Vector) -> Result<()> { for (nth, elem) in vector.into_iter().enumerate() { function.call((nth, elem))?; } Ok(()) }
pub unsafe fn call_unprotected<A>(self, args: A) -> Result<Value<'e>> where
A: IntoLispArgs<'e>,
[src]
A: IntoLispArgs<'e>,
Like call
, except that the returned Value
is not protected against
Emacs GC's bug #31238, which caused issue #2.
Safety
This can be used as an optimization, in situations when the returned Value
is unused,
or when its usage is shorter than the lifespan of the underlying Lisp object.
impl<'e> Value<'e>
[src]
pub fn make_global_ref(self) -> GlobalRef
[src]
Creates a new GlobalRef
for this value.
Trait Implementations
impl<'e> Clone for Value<'e>
[src]
impl<'e> Copy for Value<'e>
[src]
impl<'e> Debug for Value<'e>
[src]
impl<'e> FromLisp<'e> for Value<'e>
[src]
impl<'e> IntoLisp<'e> for Value<'e>
[src]
Auto Trait Implementations
impl<'e> !RefUnwindSafe for Value<'e>
impl<'e> !Send for Value<'e>
impl<'e> !Sync for Value<'e>
impl<'e> Unpin for Value<'e>
impl<'e> !UnwindSafe for Value<'e>
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,