مرجع توابع
همهٔ توابع و مقدارهای زبان به تفکیک فضای نام، با امضا، اثر، هزینه و مثالهای آزموده؛ ساختهشده از رجیستری موتور.
این مرجع از رجیستری موتور ساخته میشود، پس دقیقاً همان نامهایی را فهرست میکند که بررسیکننده میپذیرد، با همان پارامترهایی که میپذیرد. هر صفحه یک فضای نام است. برای هر تابع امضای آن (پارامترهای اختیاری در کروشه)، کاری که با اسکریپت میکند (اثر آن)، زمانی که اجرا میشود (مرحلهٔ آن)، هزینهاش و مثالهای آزمودهای را که از آن استفاده میکنند میآورد.
یک مدخل را چطور بخوانیم#
- اثر. تابعی که اثری ندارد فقط به آرگومانهایش بستگی دارد. تابعی که حالت نگه میدارد (یک میانگین متحرک، یک درخواست) برای هر جایی که نوشته شده یک حالت دارد و هر بار که اجرا به آن جا برسد، حالت را جلو میبرد؛ به همین دلیل چنین فراخوانیای نمیتواند جایی بنشیند که ممکن است اجرا نشود (نگاه کنید به تشخیصها: کدهای خطا و اخطار، E3302 و W3302).
- مرحله. بیشتر توابع روی هر کندل اجرا میشوند. اعلانها و تنظیمات یک بار، در مرحلهٔ آمادهسازی، اجرا میشوند.
- هزینه. هر فراخوانی از بودجهٔ اجرا خرج میکند: 500,000 عملیات برای هر کندل و 600,000,000 برای یک اجرا. فراخوانیای که حالت نگه میدارد حافظه هم نگه میدارد؛ فراخوانیای که مجموعه یا متن میسازد در دفتر حافظه شمرده میشود. نگاه کنید به سقفها و بودجهٔ اجرا.
- مثالها. مثالها برنامههایی هستند که هر بار که مستندات ساخته میشود، روی دادههای مصنوعیِ دانهدار (seeded) کامپایل و اجرا میشوند.