Objek Fungsi

Terdapat beberapa fungsi spesifik untuk fungsi Python.

type PyFunctionObject

Struktur C yang digunakan untuk fungsi.

PyTypeObject PyFunction_Type

Ini adalah instance dari PyTypeObject dan mewakili jenis fungsi Python. Itu diekspos ke programmer Python sebagai types.FunctionType.

int PyFunction_Check(PyObject *o)

Mengembalikan nilai true jika o adalah objek fungsi (memiliki tipe PyFunction_Type). Parameter tidak boleh NULL. Fungsi ini selalu sukses.

PyObject *PyFunction_New(PyObject *code, PyObject *globals)

Return value: New reference.

Mengembalikan objek fungsi baru yang terkait dengan objek kode code. global harus berupa dictionary dengan variabel global yang dapat diakses oleh fungsi tersebut.

The function's docstring and name are retrieved from the code object. __module__ is retrieved from globals. The argument defaults, annotations and closure are set to NULL. __qualname__ is set to the same value as the code object's co_qualname field.

PyObject *PyFunction_NewWithQualName(PyObject *code, PyObject *globals, PyObject *qualname)

Return value: New reference.

As PyFunction_New(), but also allows setting the function object's __qualname__ attribute. qualname should be a unicode object or NULL; if NULL, the __qualname__ attribute is set to the same value as the code object's co_qualname field.

Added in version 3.3.

PyObject *PyFunction_GetCode(PyObject *op)

Return value: Borrowed reference.

Mengembalikan objek kode yang terkait dengan objek fungsi op.

PyObject *PyFunction_GetGlobals(PyObject *op)

Return value: Borrowed reference.

Mengembalikan dictionary global yang terkait dengan objek fungsi op.

PyObject *PyFunction_GetModule(PyObject *op)

Return value: Borrowed reference.

Return a borrowed reference to the __module__ attribute of the function object op. It can be NULL.

This is normally a string containing the module name, but can be set to any other object by Python code.

PyObject *PyFunction_GetDefaults(PyObject *op)

Return value: Borrowed reference.

Mengembalikan nilai argumen default dari objek fungsi op. Ini bisa berupa argumen tuple atau NULL.

int PyFunction_SetDefaults(PyObject *op, PyObject *defaults)

Menetapkan nilai argumen default untuk objek fungsi op. default harus Py_None atau tuple.

Menimbulkan SystemError dan mengembalikan -1 jika gagal.

void PyFunction_SetVectorcall(PyFunctionObject *func, vectorcallfunc vectorcall)

Set the vectorcall field of a given function object func.

Warning: extensions using this API must preserve the behavior of the unaltered (default) vectorcall function!

Added in version 3.12.

PyObject *PyFunction_GetClosure(PyObject *op)

Return value: Borrowed reference.

Mengembalikan penutupan yang terkait dengan objek fungsi op. Ini bisa berupa NULL atau tuple objek sel.

int PyFunction_SetClosure(PyObject *op, PyObject *closure)

Mengatur penutupan yang terkait dengan objek fungsi op. closure harus berupa Py_None atau tuple objek sel.

Menimbulkan SystemError dan mengembalikan -1 jika gagal.

PyObject *PyFunction_GetAnnotations(PyObject *op)

Return value: Borrowed reference.

Kembalikan anotasi objek fungsi op. Ini bisa berupa dictionary yang bisa berubah atau NULL.

int PyFunction_SetAnnotations(PyObject *op, PyObject *annotations)

Mengatur anotasi untuk objek fungsi op. annotations harus berupa dictionary atau Py_None.

Menimbulkan SystemError dan mengembalikan -1 jika gagal.

int PyFunction_AddWatcher(PyFunction_WatchCallback callback)

Register callback as a function watcher for the current interpreter. Return an ID which may be passed to PyFunction_ClearWatcher(). In case of error (e.g. no more watcher IDs available), return -1 and set an exception.

Added in version 3.12.

int PyFunction_ClearWatcher(int watcher_id)

Clear watcher identified by watcher_id previously returned from PyFunction_AddWatcher() for the current interpreter. Return 0 on success, or -1 and set an exception on error (e.g. if the given watcher_id was never registered.)

Added in version 3.12.

type PyFunction_WatchEvent

Enumeration of possible function watcher events: - PyFunction_EVENT_CREATE - PyFunction_EVENT_DESTROY - PyFunction_EVENT_MODIFY_CODE - PyFunction_EVENT_MODIFY_DEFAULTS - PyFunction_EVENT_MODIFY_KWDEFAULTS

Added in version 3.12.

typedef int (*PyFunction_WatchCallback)(PyFunction_WatchEvent event, PyFunctionObject *func, PyObject *new_value)

Type of a function watcher callback function.

If event is PyFunction_EVENT_CREATE or PyFunction_EVENT_DESTROY then new_value will be NULL. Otherwise, new_value will hold a borrowed reference to the new value that is about to be stored in func for the attribute that is being modified.

The callback may inspect but must not modify func; doing so could have unpredictable effects, including infinite recursion.

If event is PyFunction_EVENT_CREATE, then the callback is invoked after func has been fully initialized. Otherwise, the callback is invoked before the modification to func takes place, so the prior state of func can be inspected. The runtime is permitted to optimize away the creation of function objects when possible. In such cases no event will be emitted. Although this creates the possibility of an observable difference of runtime behavior depending on optimization decisions, it does not change the semantics of the Python code being executed.

If event is PyFunction_EVENT_DESTROY, Taking a reference in the callback to the about-to-be-destroyed function will resurrect it, preventing it from being freed at this time. When the resurrected object is destroyed later, any watcher callbacks active at that time will be called again.

If the callback sets an exception, it must return -1; this exception will be printed as an unraisable exception using PyErr_WriteUnraisable(). Otherwise it should return 0.

There may already be a pending exception set on entry to the callback. In this case, the callback should return 0 with the same exception still set. This means the callback may not call any other API that can set an exception unless it saves and clears the exception state first, and restores it before returning.

Added in version 3.12.