عرض مصدر Python/weakref/proxy

<noinclude>{{DISPLAYTITLE:الدالة <code>weakref.proxy()‎</code> في بايثون}}</noinclude>

تنشئ الدالة وسيطًا proxy للكائن المعطى والذي يستخدم إشارة ضعيفة.

== البنية العامة ==

<syntaxhighlight lang="python3">
weakref.proxy(object[, callback])
</syntaxhighlight>

== المعاملات ==

===<code>object</code>===

الكائن المراد إنشاء وسيط له.

===<code>callback</code>===

المعامل <code>callback</code> هو نفس المعامل الموجود في الدالة <code>[[Python/weakref/ref|ref()‎]]</code>.

== القيمة المعادة ==

تعيد الدالة وسيطًا proxy للكائن المعطى والذي يستخدم إشارة ضعيفة. تدعم هذه الدالة استخدام الوسيط في معظم السياقات عوضًا عن الحاجة إلى التصريح عن عملية إلغاء الإشارة والتي تستخدم مع كائنات الإشارة الضعيفة.

الكائن المعاد من هذه الدالة سيكون إما من نوع <code>ProxyType</code> أو <code>CallableProxyType</code> وذلك بالاعتماد على ما إذا كان الكائن المعطى قابلًا للاستدعاء أو لا. 

كائنات الوسيط غير قابلة للتقطيع بصرف النظر عن نوع الكائن المشار إليه، ويساعد هذا الأمر في تجنب عدد من المشاكل المرتبطة بقابلية هذه الكائنات على التغيير mutable، وتمنع كذلك استخدامها كمفاتيح في [[Python/dict|القواميس]].

== مصادر ==
[https://docs.python.org/3/library/weakref.html#weakref.proxy صفحة Weak references في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]