함수 객체¶

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

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)¶: 현재 인터프리터에 대한 함수 감시자(watcher)로 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)¶

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

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.

콜백은 func 를 검사할 수 있지만, 수정해서는 안 됩니다. 이렇게 하면 무한 재귀를 포함하여 예측할 수 없는 영향을 줄 수 있습니다.

만약 event 가 PyFunction_EVENT_CREATE 라면, 콜백은 func 가 완전히 초기화된 후에 호출됩니다. 그렇지 않다면, 콜백은 func 에 대한 수정이 발생하는 이전에 호출되므로, func 의 이전 상태를 검사할 수 있습니다. 런타임은 가능하다면 함수 객체의 생성을 최적화할 수 있습니다. 그런 경우에는 이벤트가 방출되지 않습니다. 이는 런타임 동작의 관찰 가능한 차이 가능성을 생성하지만, 실행 중인 Python 코드의 의미론을 변경하지는 않습니다.

만약 event 가 PyFunction_EVENT_DESTROY 라면, 콜백에서 곧 파괴될 함수에 대한 참조를 가져가면 그것을 부활시켜, 이 시점에서 메모리 해제되는 것을 방지할 수 있습니다. 부활된 객체가 나중에 파괴될 때, 그 시점에 활성 상태였던 모든 감시자 콜백이 다시 호출됩니다.

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

콜백 호출 진입 시 이미 보류 중인 예외가 설정되어 있을 수 있습니다. 이 경우, 콜백은 동일한 예외가 여전히 설정된 상태로 0 을 반환해야 합니다. 이는 콜백이 예외를 설정할 수 있는 다른 API를 호출하지 않을 수도 있다는 것을 의미하며, 그렇지 않다면 예외 상태를 먼저 저장하고 지운 다음, 반환하기 전에 복원해야 합니다.

Added in version 3.12.

함수 객체¶

분실물 보관소