Python

함수 객체

파이썬 함수와 관련된 몇 가지 함수가 있습니다.

type PyFunctionObject

함수에 사용되는 C 구조체.

PyTypeObject PyFunction_Type

이것은 PyTypeObject의 인스턴스이며 파이썬 함수 형을 나타냅니다. 파이썬 프로그래머에게 types.FunctionType으로 노출됩니다.

int PyFunction_Check(PyObject *o)

o가 함수 객체(PyFunction_Type 형)면 참을 반환합니다. 매개 변수는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

PyObject *PyFunction_New(PyObject *code, PyObject *globals)
반환값: 새 참조.

코드 객체 code와 연관된 새 함수 객체를 반환합니다. globals는 함수에서 액세스할 수 있는 전역 변수가 있는 딕셔너리이어야 합니다.

함수의 독스트링과 이름은 코드 객체에서 가져옵니다. __module__은 globals에서 가져옵니다. 인자 기본값, 어노테이션 및 클로저는 NULL로 설정됩니다. __qualname__은 코드 객체의 co_qualname 필드와 같은 값으로 설정됩니다.

PyObject *PyFunction_NewWithQualName(PyObject *code, PyObject *globals, PyObject *qualname)
반환값: 새 참조.

PyFunction_New()와 비슷하지만, 함수 객체의 __qualname__ 어트리뷰트를 설정할 수도 있도록 합니다. qualname는 유니코드 객체나 NULL이어야 합니다; NULL이면, __qualname__ 어트리뷰트는 코드 객체의 co_qualname 필드와 같은 값으로 설정됩니다.

Added in version 3.3.

PyObject *PyFunction_GetCode(PyObject *op)
반환값: 빌린 참조.

함수 객체 op와 연관된 코드 객체를 반환합니다.

PyObject *PyFunction_GetGlobals(PyObject *op)
반환값: 빌린 참조.

함수 객체 op와 연관된 전역 딕셔너리를 반환합니다.

PyObject *PyFunction_GetModule(PyObject *op)
반환값: 빌린 참조.

함수 객체 op의 __module__ 어트리뷰트에 대한 빌린 참조를 반환합니다. NULL일 수 있습니다.

이것은 일반적으로 모듈 이름을 포함하는 문자열이지만, 파이썬 코드로 다른 객체로 설정할 수 있습니다.

PyObject *PyFunction_GetDefaults(PyObject *op)
반환값: 빌린 참조.

함수 객체 op의 인자 기본값을 반환합니다. 이는 인자의 튜플이나 NULL일 수 있습니다.

int PyFunction_SetDefaults(PyObject *op, PyObject *defaults)

함수 객체 op의 인자 기본값을 설정합니다. defaults는 Py_None 이나 튜플이어야 합니다.

실패하면 SystemError를 발생시키고 -1을 반환합니다.

void PyFunction_SetVectorcall(PyFunctionObject *func, vectorcallfunc vectorcall)

주어진 함수 객체 func 의 vectorcall 필드를 설정합니다.

경고: 이 API를 사용하는 확장 프로그램은 변경되지 않은(기본) vectorcall 함수의 동작을 유지해야 합니다!

Added in version 3.12.

PyObject *PyFunction_GetKwDefaults(PyObject *op)
반환값: 빌린 참조.

함수 객체 op 의 키워드 전용 인자 기본값들을 반환합니다. 이는 인자들의 딕셔너리이거나 NULL 일 수 있습니다.

int PyFunction_SetKwDefaults(PyObject *op, PyObject *defaults)

함수 객체 op 의 키워드 전용 인자 기본값들을 설정합니다. defaults 는 키워드 전용 인자들의 딕셔너리이거나 Py_None 이어야 합니다.

이 함수는 성공 시 0 을 반환하고, 실패 시 예외를 설정하며 -1 을 반환합니다.

PyObject *PyFunction_GetClosure(PyObject *op)
반환값: 빌린 참조.

함수 객체 op와 연관된 클로저를 반환합니다. 이것은 NULL 이나 셀 객체의 튜플일 수 있습니다.

int PyFunction_SetClosure(PyObject *op, PyObject *closure)

함수 객체 op와 연관된 클로저를 설정합니다. closure는 Py_None 이나 셀 객체의 튜플이어야 합니다.

실패하면 SystemError를 발생시키고 -1을 반환합니다.

PyObject *PyFunction_GetAnnotations(PyObject *op)
반환값: 빌린 참조.

함수 객체 op의 어노테이션을 반환합니다. 이것은 가변 딕셔너리나 NULL 일 수 있습니다.

int PyFunction_SetAnnotations(PyObject *op, PyObject *annotations)

함수 객체 op의 어노테이션을 설정합니다. annotations은 딕셔너리나 Py_None 이어야 합니다.

실패하면 SystemError를 발생시키고 -1을 반환합니다.

PyObject *PyFunction_GET_CODE(PyObject *op)
PyObject *PyFunction_GET_GLOBALS(PyObject *op)
PyObject *PyFunction_GET_MODULE(PyObject *op)
PyObject *PyFunction_GET_DEFAULTS(PyObject *op)
PyObject *PyFunction_GET_KW_DEFAULTS(PyObject *op)
PyObject *PyFunction_GET_CLOSURE(PyObject *op)
PyObject *PyFunction_GET_ANNOTATIONS(PyObject *op)
반환값: 빌린 참조.

이 함수들은 그에 대응하는 PyFunction_Get* 와 유사하지만 타입 체크를 수행하지 않습니다. PyFunction_Type 인스턴스가 아닌 다른 것을 전달하면 정의되지 않은 동작이 발생할 수 있습니다.

int PyFunction_AddWatcher(PyFunction_WatchCallback callback)

callback 을 현재 인터프리터의 함수 감시자로 등록합니다. PyFunction_ClearWatcher() 에 전달할 수 있는 ID를 반환합니다. 오류가 발생한 경우(예: 더 이상 사용 가능한 감시자 ID가 없는 경우), -1 을 반환하고 예외를 설정합니다.

Added in version 3.12.

int PyFunction_ClearWatcher(int watcher_id)

현재 인터프리터에 대해 PyFunction_AddWatcher() 에서 이전에 반환된 watcher_id 로 식별되는 감시자를 제거합니다. 성공 시 0 을 반환하고, 오류 발생 시(예: 제공된 watcher_id 가 등록된 적이 없는 경우) -1 을 반환하고 예외를 설정합니다.

Added in version 3.12.

type PyFunction_WatchEvent

가능한 함수 감시자 이벤트의 열거형:

  • PyFunction_EVENT_CREATE

  • PyFunction_EVENT_DESTROY

  • PyFunction_EVENT_MODIFY_CODE

  • PyFunction_EVENT_MODIFY_DEFAULTS

  • PyFunction_EVENT_MODIFY_KWDEFAULTS

Added in version 3.12:

  • PyFunction_PYFUNC_EVENT_MODIFY_QUALNAME

Added in version 3.15.

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

함수 감시자 콜백 함수의 타입입니다.

event 이 PyFunction_EVENT_CREATE 또는 PyFunction_EVENT_DESTROY 인 경우 new_value 는 NULL 입니다. 그렇지 않은 경우, new_value 는 수정 중인 속성에 저장될 새로운 값에 대한 borrowed reference 를 보유합니다.

콜백은 func 를 검사할 수는 있지만 수정해서는 안 됩니다. 이를 변경하면 무한 재귀를 포함하여 예측할 수 없는 결과가 발생할 수 있습니다.

event 이 PyFunction_EVENT_CREATE 인 경우, 콜백은 func 가 완전히 초기화된 후에 호출됩니다. 그렇지 않은 경우에는 콜백이 func 를 수정하기 전에 실행되므로 이전 상태를 검사할 수 있습니다. 런타임은 가능한 경우 함수 객체의 생성을 최적화하여 제거할 수 있으며, 이 경우 아무런 이벤트도 발생하지 않습니다. 이는 최적화 결정에 따라 런타임 동작에 관찰 가능한 차이가 발생할 가능성을 만드나, 실행되는 Python 코드의 의미(semantics)를 변경하지는 않습니다.

event 이 PyFunction_EVENT_DESTROY 인 경우, 콜백에서 파괴될 예정인 함수에 대한 참조를 가져오면 해당 함수가 다시 살아나며(resurrect) 이 시점에 해제되는 것을 방지합니다. 복원된 객체가 나중에 파괴될 때, 당시 활성화된 모든 감시자 콜백이 다시 호출됩니다.

콜백이 예외를 설정하는 경우 반드시 -1 을 반환해야 합니다. 이 예외는 PyErr_WriteUnraisable() 을 사용하여 발생할 수 없는 예외로 출력됩니다. 그렇지 않은 경우에는 0 을 반환해야 합니다.

콜백 진입 시 이미 설정된 대기 중인 예외가 있을 수 있습니다. 이 경우 콜백은 동일한 예외가 설정된 상태로 0 을 반환해야 합니다. 이는 콜백이 먼저 예외 상태를 저장하고 삭제한 후, 반환하기 전에 이를 복구하지 않는 한 예외를 설정할 수 있는 다른 API를 호출해서는 안 된다는 것을 의미합니다.

Added in version 3.12.

분실물 보관소