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"
prefer using ::type_object(py).name() to get the correct runtime value
Source§const MODULE: Option<&'static str>
const MODULE: Option<&'static str>
prefer using ::type_object(py).module() to get the correct runtime value
Source§const TYPE_HINT: PyStaticExpr
const TYPE_HINT: PyStaticExpr
Source§fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
Source§fn is_type_of(obj: &Bound<'_, PyAny>) -> bool
fn is_type_of(obj: &Bound<'_, PyAny>) -> bool
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 UnsafeUnpin 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
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>
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>
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;
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.