pub struct PyCFunction(/* private fields */);Expand description
Represents a builtin Python function object.
Values of this type are accessed via PyO3’s smart pointers, e.g. as
Py<PyCFunction> or Bound<'py, PyCFunction>.
Implementations§
Source§impl PyCFunction
impl PyCFunction
Sourcepub fn new_with_keywords<'py>(
py: Python<'py>,
fun: PyCFunctionWithKeywords,
name: &'static CStr,
doc: &'static CStr,
module: Option<&Bound<'py, PyModule>>,
) -> PyResult<Bound<'py, Self>>
pub fn new_with_keywords<'py>( py: Python<'py>, fun: PyCFunctionWithKeywords, name: &'static CStr, doc: &'static CStr, module: Option<&Bound<'py, PyModule>>, ) -> PyResult<Bound<'py, Self>>
Create a new built-in function with keywords (*args and/or **kwargs).
To create name and doc static strings on Rust versions older than 1.77 (which added c““ literals),
use the c_str! macro.
Sourcepub fn new<'py>(
py: Python<'py>,
fun: PyCFunction,
name: &'static CStr,
doc: &'static CStr,
module: Option<&Bound<'py, PyModule>>,
) -> PyResult<Bound<'py, Self>>
pub fn new<'py>( py: Python<'py>, fun: PyCFunction, name: &'static CStr, doc: &'static CStr, module: Option<&Bound<'py, PyModule>>, ) -> PyResult<Bound<'py, Self>>
Create a new built-in function which takes no arguments.
To create name and doc static strings on Rust versions older than 1.77 (which added c““ literals),
use the c_str! macro.
Sourcepub fn new_closure<'py, F, R>(
py: Python<'py>,
name: Option<&'static CStr>,
doc: Option<&'static CStr>,
closure: F,
) -> PyResult<Bound<'py, Self>>
pub fn new_closure<'py, F, R>( py: Python<'py>, name: Option<&'static CStr>, doc: Option<&'static CStr>, closure: F, ) -> PyResult<Bound<'py, Self>>
Create a new function from a closure.
§Examples
Python::attach(|py| {
let add_one = |args: &Bound<'_, PyTuple>, _kwargs: Option<&Bound<'_, PyDict>>| -> PyResult<_> {
let i = args.extract::<(i64,)>()?.0;
Ok(i+1)
};
let add_one = PyCFunction::new_closure(py, None, None, add_one).unwrap();
py_run!(py, add_one, "assert add_one(42) == 43");
});Trait Implementations§
Source§impl PyTypeInfo for PyCFunction
impl PyTypeInfo for PyCFunction
Source§const NAME: &'static str = "PyCFunction"
const NAME: &'static str = "PyCFunction"
👎Deprecated since 0.28.0: prefer using
::type_object(py).name() to get the correct runtime valueClass name.
Source§const MODULE: Option<&'static str>
const MODULE: Option<&'static str>
👎Deprecated since 0.28.0: prefer using
::type_object(py).module() to get the correct runtime valueModule name, if any.
Source§fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
Returns the PyTypeObject instance for this type.
Source§fn is_type_of(obj: &Bound<'_, PyAny>) -> bool
fn is_type_of(obj: &Bound<'_, PyAny>) -> bool
Checks if
object is an instance of this type or a subclass of this type.impl DerefToPyAny for PyCFunction
Auto Trait Implementations§
impl !Freeze for PyCFunction
impl !RefUnwindSafe for PyCFunction
impl !Send for PyCFunction
impl !Sync for PyCFunction
impl Unpin for PyCFunction
impl UnwindSafe for PyCFunction
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<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> PyTypeCheck for Twhere
T: PyTypeInfo,
impl<T> PyTypeCheck for Twhere
T: PyTypeInfo,
Source§const NAME: &'static str = const NAME: &'static str = T::NAME;
const NAME: &'static str = const NAME: &'static str = T::NAME;
👎Deprecated since 0.27.0: Use ::classinfo_object() instead and format the type name at runtime. Note that using built-in cast features is often better than manual PyTypeCheck usage.
Name of self. This is used in error messages, for example.
Source§const TYPE_HINT: TypeHint = const TYPE_HINT: TypeHint = <T as PyTypeInfo>::TYPE_HINT;
const TYPE_HINT: TypeHint = const TYPE_HINT: TypeHint = <T as PyTypeInfo>::TYPE_HINT;
Provides the full python type of the allowed values as a Python type hint.