بازتاب¶

PyObject *PyEval_GetBuiltins(void)¶

مقدار بازگشتی: مرجع امانتی. قسمتی از ABI پایدار.

منسوخ شده از نسخه‌ی 3.13: به‌جای آن از PyEval_GetFrameBuiltins() استفاده کنید.

بازگرداندن دیکشنری‌ای از توکارها در فریم اجرای فعلی، یا در مفسر وضعیت نخ، در صورتی که هیچ فریمی در حال اجرا نباشد.

PyObject *PyEval_GetLocals(void)¶

مقدار بازگشتی: مرجع امانتی. قسمتی از ABI پایدار.

منسوخ شده از نسخه‌ی 3.13: برای به دست آوردن همان رفتاری که فراخوانی locals() در کد پایتون دارد، از PyEval_GetFrameLocals() استفاده کنید، یا برای دسترسی به ویژگی f_locals از فریم در حال اجرا، PyFrame_GetLocals() را بر روی نتیجه‌ی PyEval_GetFrame() فراخوانی کنید.

نگاشتی را برمی‌گرداند که دسترسی به متغیرهای محلی در فریم اجرای فعلی (execution frame) را فراهم می‌کند، یا اگر هم‌اکنون هیچ فریمی در حال اجرا نباشد، NULL برمی‌گرداند.

برای جزئیات نگاشتی که در محدوده‌های مختلف بازگردانده می‌شود، به locals() مراجعه کنید.

از آن‌جا که این تابع یک ارجاع امانتی برمی‌گرداند، دیکشنری برگردانده‌شده برای محدوده‌های بهینه‌شده روی شیء فریم نهانگاه می‌شود و تا زمانی که شیء فریم زنده است، زنده باقی می‌ماند. برخلاف PyEval_GetFrameLocals() و locals()، فراخوانی‌های بعدی این تابع در همان فریم، محتوای دیکشنری نهانگاه‌شده را به‌روزرسانی می‌کنند تا تغییرات وضعیت متغیرهای محلی را منعکس کنند، نه اینکه تصویر لحظه‌ای جدیدی برگردانند.

تغییر یافته در نسخه‌ی 3.13: به عنوان بخشی از PEP 667، PyFrame_GetLocals()، locals() و FrameType.f_locals دیگر از دیکشنری نهانگاه مشترک استفاده نمی‌کنند. برای جزئیات بیشتر به مدخل تازه‌ها مراجعه کنید.

PyObject *PyEval_GetGlobals(void)¶

مقدار بازگشتی: مرجع امانتی. قسمتی از ABI پایدار.

منسوخ شده از نسخه‌ی 3.13: به جای آن از PyEval_GetFrameGlobals() استفاده کنید.

دیکشنری‌ای از متغیرهای سراسری در فریم اجرای فعلی را برمی‌گرداند، یا NULL اگر هم‌اکنون هیچ فریمی در حال اجرا نباشد.

PyFrameObject *PyEval_GetFrame(void)¶

مقدار بازگشتی: مرجع امانتی. قسمتی از ABI پایدار.

فریم attached thread state را برمی‌گرداند که اگر در حال حاضر هیچ فریمی در حال اجرا نباشد، NULL است.

همچنین PyThreadState_GetFrame() را ببینید.

PyObject *PyEval_GetFrameBuiltins(void)¶

مقدار بازگشتی: مرجع جدید. قسمتی از ABI پایدار از نسخه‌ی 3.13.

بازگرداندن دیکشنری‌ای از توکارها در فریم اجرای فعلی، یا در مفسر وضعیت نخ، در صورتی که هیچ فریمی در حال اجرا نباشد.

اضافه شده در نسخه‌ی 3.13.

PyObject *PyEval_GetFrameLocals(void)¶

مقدار بازگشتی: مرجع جدید. قسمتی از ABI پایدار از نسخه‌ی 3.13.

یک دیکشنری از متغیرهای محلی در فریم اجرای فعلی را برمی‌گرداند، یا NULL اگر در حال حاضر هیچ فریمی در حال اجرا نباشد. معادل فراخوانی locals() در کد پایتون است.

برای دسترسی به f_locals در فریم فعلی بدون ایجاد تصویر لحظه‌ای مستقل در محدوده‌های بهینه‌شده، PyFrame_GetLocals() را روی نتیجه‌ی PyEval_GetFrame() فراخوانی کنید.

اضافه شده در نسخه‌ی 3.13.

PyObject *PyEval_GetFrameGlobals(void)¶

مقدار بازگشتی: مرجع جدید. قسمتی از ABI پایدار از نسخه‌ی 3.13.

یک دیکشنری از متغیرهای سراسری در فریم اجرای جاری برمی‌گرداند، یا اگر هیچ فریمی در حال اجرا نباشد، NULL برمی‌گرداند. معادل فراخوانی globals() در کد پایتون است.

اضافه شده در نسخه‌ی 3.13.

const char *PyEval_GetFuncName(PyObject *func)¶

قسمتی از ABI پایدار.

اگر func یک تابع، کلاس یا شیء نمونه باشد، نام func و در غیر این صورت نام نوع func را برمی‌گرداند.

For a Python function or method, the returned pointer refers to the function's name and must not be retained across operations that may change that name. In the free-threaded build, copy the string before detaching the thread state or executing Python code if the name may be modified concurrently.

const char *PyEval_GetFuncDesc(PyObject *func)¶

قسمتی از ABI پایدار.

بسته به نوع func، یک رشته‌ی توصیفی برمی‌گرداند. مقادیر بازگشتی شامل "()" برای توابع و متدها، " constructor"، " instance" و " object" است. اگر با نتیجه‌ی PyEval_GetFuncName() الحاق شود، نتیجه، توصیفی از func خواهد بود.