کتابخانه‌ی استاندارد · زمان و همروندی

کانال chan

کانال برای فرستادن مقدار از یک نخ به نخ دیگر، با بافر، مهلت و بستن.

واردسازی کانال

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

کانال صفی است که چند نخ از یک سر آن مقدار می‌فرستند و از سر دیگر دریافت می‌کنند؛ قفل‌ها و انتظارها را خودش مدیریت می‌کند. گونه‌ی مقدارها را هنگام ساختن می‌گویید، مثل کانال.کانال<صحیح۶۴>، و پیش از استفاده مقداردهی را با ظرفیت صدا می‌زنید.

اگر بافر پر باشد، فرستادن صبر می‌کند؛ اگر خالی باشد، دریافت. کانال با ظرفیت صفر «بی‌بافر» است: فرستنده تا وقتی گیرنده مقدار را برندارد صبر می‌کند. پس از بستن، فرستادن نادرست برمی‌گرداند ولی گیرنده‌ها هنوز مقدارهای مانده را می‌گیرند؛ وقتی کانال خالی شد، باز نادرست می‌شود و حلقه‌ی گیرنده می‌تواند تمام شود.

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

اشتباه‌های رایج:

  • فراموش کردن مقداردهی. کانالی که با کانال.کانال {} تعریف شده هنوز میان‌گیر و قفلی ندارد و با نخستین فرستادن برنامه را از کار می‌اندازد.
  • به کار بردن مقدار یک دریافت ناموفق. وقتی باز نادرست است، نتیجه یک مقدار صفر بی‌معناست.
  • جدا نکردن پایان مهلت از پایان کار. دریافت با مهلت هم وقتی زمان تمام شده و هم وقتی کانال بسته و خالی است باز را نادرست می‌کند؛ برای فهمیدن این‌که کدام بوده، بسته است را بپرسید.
  • فرستادن یک وکتور یا اشاره‌گر و سپس تغییر دادنش. کانال مقدار را رونوشت می‌کند، که برای این گونه‌ها فقط دسته است؛ پس هر دو نخ همان حافظه را می‌بینند.

حلقه‌ی دریافت

تقریباً همه‌ی مصرف‌کننده‌ها یک شکل دارند: در یک حلقه‌ی بی‌پایان تا درست: دریافت می‌کنند و وقتی باز نادرست شد بشکن می‌زنند. این فقط وقتی پیش می‌آید که کانال بسته و خالی باشد، پس هیچ مقداری گم نمی‌شود. قاعده‌ای که با آن همراه است: طرفی که می‌فرستد همان طرفی است که می‌بندد، وقتی دیگر چیزی برای فرستادن ندارد.

chan-guide-loop.salam
واردسازی کانال

ناپایا سفارش‌ها := کانال.کانال {} برگردان کانال.کانال<رشته>

تابع پرداخت():
    هر شناسه در ["A-1001"، "A-1002"، "A-1003"]:
        سفارش‌ها.فرستادن(شناسه)
    پایان
    سفارش‌ها.بستن()
    سرچاپ "پس از بستن، فرستادن کار می‌کند:"، سفارش‌ها.فرستادن("A-1004")
پایان

تابع ریشه:
    سفارش‌ها.مقداردهی(۸)
    ن := نخ‌ساز(پرداخت)
    نخ‌پیوند(ن)
    سرچاپ "منتظر در میان‌گیر:"، سفارش‌ها.طول()
    ناپایا باز := درست
    تا درست:
        شناسه := سفارش‌ها.دریافت(باز)
        اگر وارونه باز: بشکن پایان
        سرچاپ "بسته‌بندی"، شناسه
    پایان
    سرچاپ "بسته و خالی:"، سفارش‌ها.بسته است()، سفارش‌ها.طول()
    سفارش‌ها.آزادسازی()
پایان
خروجیپس از بستن، فرستادن کار می‌کند: false منتظر در میان‌گیر: 3 بسته‌بندی A-1001 بسته‌بندی A-1002 بسته‌بندی A-1003 بسته و خالی: true 0

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

خط لوله‌ای از مرحله‌ها

کانال‌ها مرحله‌هایی را به هم وصل می‌کنند که هر کدام یک کار می‌کنند. این‌جا یک نخ عدد می‌سازد، نخ دوم آن‌ها را به توان دو می‌رساند و نخ اصلی جمعشان می‌کند. هر مرحله وقتی ورودی‌اش تمام شد کانال خروجی‌اش را می‌بندد، پس پایان داده خودبه‌خود در خط لوله پایین می‌رود و هر حلقه خودش می‌ایستد.

chan-guide-pipeline.salam
واردسازی کانال

ناپایا عددها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا مربع‌ها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>

تابع تولید():
    تکرار ۱ تا ۱۰ در ع:
        عددها.فرستادن(ع برگردان صحیح۶۴)
    پایان
    عددها.بستن()
پایان

تابع مربع کردن():
    ناپایا باز := درست
    تا درست:
        ع := عددها.دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        مربع‌ها.فرستادن(ع * ع)
    پایان
    مربع‌ها.بستن()
پایان

تابع ریشه:
    عددها.مقداردهی(۲)
    مربع‌ها.مقداردهی(۲)
    الف := نخ‌ساز(تولید)
    ب := نخ‌ساز(مربع کردن)
    ناپایا جمع := ۰ برگردان صحیح۶۴
    ناپایا شمار := ۰
    ناپایا باز := درست
    تا درست:
        م := مربع‌ها.دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        جمع += م
        شمار++
    پایان
    نخ‌پیوند(الف)
    نخ‌پیوند(ب)
    سرچاپ "مقدارهایی که از خط لوله گذشتند:"، شمار
    سرچاپ "جمع مربع‌ها:"، جمع
    عددها.آزادسازی()
    مربع‌ها.آزادسازی()
پایان
خروجیمقدارهایی که از خط لوله گذشتند: 10 جمع مربع‌ها: 385

هر کانال فقط دو مقدار جا دارد. وقتی مرحله‌ی آخر کند است، مرحله‌های قبلی در فرستادن منتظر می‌مانند و حافظه را پر نمی‌کنند؛ به این «فشار برگشتی» می‌گویند.

پرسیدن و منتظر پاسخ ماندن

دو کانال یک جفت درخواست و پاسخ می‌سازند: یکی پرسش‌ها را به کارگر می‌برد و دیگری پاسخ‌ها را برمی‌گرداند. با ظرفیت صفر، هر فرستادن صبر می‌کند تا طرف دیگر مقدار را بگیرد، پس دو نخ هم‌قدم پیش می‌روند و پاسخ‌ها به همان ترتیبی برمی‌گردند که پرسش‌ها رفته بودند.

chan-guide-reply.salam
واردسازی کانال

ناپایا درخواست‌ها := کانال.کانال {} برگردان کانال.کانال<رشته>
ناپایا پاسخ‌ها := کانال.کانال {} برگردان کانال.کانال<رشته>

تابع کارساز():
    ناپایا باز := درست
    تا درست:
        نام := درخواست‌ها.دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        پاسخ‌ها.فرستادن("سلام، " + نام)
    پایان
پایان

تابع ریشه:
    درخواست‌ها.مقداردهی(۰)
    پاسخ‌ها.مقداردهی(۰)
    ن := نخ‌ساز(کارساز)
    ناپایا باز := درست
    هر نام در ["سارا"، "رضا"، "مینا"]:
        درخواست‌ها.فرستادن(نام)
        سرچاپ پاسخ‌ها.دریافت(باز)
    پایان
    درخواست‌ها.بستن()
    نخ‌پیوند(ن)
    درخواست‌ها.آزادسازی()
    پاسخ‌ها.آزادسازی()
پایان
خروجیسلام، سارا سلام، رضا سلام، مینا

چند فرستنده، یک گیرنده

وقتی چند نخ در یک کانال می‌فرستند، هیچ‌کدام نمی‌تواند آن را ببندد، چون هر کدام فقط می‌داند که خودش تمام کرده است. فرستنده‌ها را با یک همگام سازی.گروه انتظار بشمارید و یک نخ کوچک دیگر بگذارید که منتظر گروه بماند و بعد کانال را ببندد.

chan-guide-fanin.salam
واردسازی کانال
واردسازی همگام سازی

ناپایا رویدادها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا فرستنده‌ها := همگام سازی.گروه انتظار {}

تابع حسگر(پایه: صحیح۶۴):
    تکرار ۵ در ای:
        رویدادها.فرستادن(پایه + ای برگردان صحیح۶۴)
    پایان
    همگام سازی.اتمام(فرستنده‌ها)
پایان

تابع حسگر الف(): حسگر(۱۰۰) پایان
تابع حسگر ب(): حسگر(۲۰۰) پایان
تابع حسگر پ(): حسگر(۳۰۰) پایان

تابع بندنده():
    همگام سازی.انتظار(فرستنده‌ها)
    رویدادها.بستن()
پایان

تابع ریشه:
    رویدادها.مقداردهی(۴)
    فرستنده‌ها = همگام سازی.گروه انتظار جدید()
    همگام سازی.افزودن(فرستنده‌ها، ۳)
    الف := نخ‌ساز(حسگر الف)
    ب := نخ‌ساز(حسگر ب)
    پ := نخ‌ساز(حسگر پ)
    ت := نخ‌ساز(بندنده)
    ناپایا سهم حسگرها := [۰، ۰، ۰]
    ناپایا باز := درست
    تا درست:
        م := رویدادها.دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        سهم حسگرها[م / ۱۰۰ - ۱]++
    پایان
    نخ‌پیوند(الف)
    نخ‌پیوند(ب)
    نخ‌پیوند(پ)
    نخ‌پیوند(ت)
    سرچاپ "از حسگر الف:"، سهم حسگرها[۰]
    سرچاپ "از حسگر ب:"، سهم حسگرها[۱]
    سرچاپ "از حسگر پ:"، سهم حسگرها[۲]
    همگام سازی.نابودسازی گروه انتظار(فرستنده‌ها)
    رویدادها.آزادسازی()
پایان
خروجیاز حسگر الف: 5 از حسگر ب: 5 از حسگر پ: 5

مقدارهای فرستنده‌های مختلف بی‌ترتیب مشخصی در هم می‌رسند، برای همین برنامه آن‌ها را برای هر فرستنده می‌شمارد و هم‌زمان با رسیدن چاپشان نمی‌کند.

وقتی کانال پر است

فرستادن منتظر جا می‌ماند و این همیشه آن چیزی نیست که می‌خواهید. کارسازی که زیر بار است اغلب بهتر است کار اضافه را همان لحظه رد کند تا این‌که همه‌ی درخواست‌کننده‌ها را منتظر بگذارد. تلاش برای فرستادن وقتی جا نیست بی‌درنگ نادرست برمی‌گرداند و تلاش برای دریافت همین کار را برای کانال خالی می‌کند.

chan-guide-shed.salam
واردسازی کانال

تابع ریشه:
    ناپایا صف := کانال.کانال {} برگردان کانال.کانال<صحیح>
    صف.مقداردهی(۳)
    ناپایا پذیرفته := ۰
    ناپایا کنارگذاشته := ۰
    تکرار ۱ تا ۸ در درخواست:
        اگر صف.کوشش برای فرستادن(درخواست):
            پذیرفته++
        وگرنه:
            کنارگذاشته++
        پایان
    پایان
    سرچاپ "پذیرفته:"، پذیرفته، "کنار گذاشته:"، کنارگذاشته، "در انتظار:"، صف.طول()
    ناپایا باز := درست
    تا درست:
        د := صف.کوشش برای دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        سرچاپ "رسیدگی به درخواست"، د
    پایان
    سرچاپ "صف خالی است:"، صف.طول() == ۰
    صف.آزادسازی()
پایان
خروجیپذیرفته: 3 کنار گذاشته: 5 در انتظار: 3 رسیدگی به درخواست 1 رسیدگی به درخواست 2 رسیدگی به درخواست 3 صف خالی است: true

میان این دو، فرستادن با مهلت و دریافت با مهلت هستند که حداکثر به اندازه‌ی میلی‌ثانیه‌های داده‌شده صبر می‌کنند.

اگر کانال پر یا خالی باشدفرستادندریافت
هر قدر لازم است صبر کنفرستادندریافت
حداکثر چند میلی‌ثانیه صبر کنفرستادن با مهلتدریافت با مهلت
اصلاً صبر نکنتلاش برای فرستادنتلاش برای دریافت

دو اشتباه را نکنید: دریافت از کانالی که هیچ‌کس نه در آن می‌فرستد و نه آن را می‌بندد برای همیشه منتظر می‌ماند، و صدا زدن آزادسازی وقتی نخ دیگری هنوز از کانال استفاده می‌کند. اول به نخ‌ها بپیوندید، بعد آزاد کنید.

راه کوتاه‌تر

جدید کانال آماده می‌سازد، پس تنها چیز اضافه، برگردان گونه است: نویسه := کانال.جدید(8) برگردان کانال.کانال<صحیح۶۴>. تابع‌های آزاد فرستادن، دریافت، کوشش برای فرستادن، کوشش برای دریافت، بستن، طول، ظرفیت و بسته است کانال را نخستین آرگومان می‌گیرند و همان کار متد هم‌نام را می‌کنند. فرستادن همه یک وکتور کامل را می‌فرستد و با نخستین شکست می‌ایستد؛ برداشتن حداکثر تعدادی را دریافت می‌کند؛ و تخلیه هر چه مانده را تا بسته و خالی شدن کانال دریافت می‌کند.

chan-API.salam
// زبان: فارسی
بسته ریشه

واردسازی کانال

تابع ریشه:
    نویسه := کانال.جدید(3) برگردان کانال.کانال<رشته>
    سرچاپ "capacity:"، کانال.ظرفیت(نویسه)، "len:"، کانال.طول(نویسه)

    واژه‌ها := وکتور {} برگردان وکتور<رشته>
    واژه‌ها.بیفزا("one")
    واژه‌ها.بیفزا("two")
    سرچاپ "sent:"، کانال.فرستادن همه(نویسه، واژه‌ها)
    سرچاپ "queued:"، کانال.طول(نویسه)
    واژه‌ها.آزادکن()

    ناپایا موفق := نادرست
    سرچاپ "first:"، کانال.دریافت(نویسه، موفق)، موفق
    سرچاپ "next:"، کانال.کوشش برای دریافت(نویسه، موفق)، موفق
    کانال.بستن(نویسه)
    سرچاپ "closed:"، کانال.بسته است(نویسه)، "send:"، کانال.کوشش برای فرستادن(نویسه، "late")

    چپ := کانال.تخلیه(نویسه)
    سرچاپ "left:"، چپ.طول()
    چپ.آزادکن()
    نویسه.آزادسازی()
پایان
خروجیcapacity: 3 len: 0 sent: true queued: 2 first: one true next: two true closed: true send: false left: 0

گزینش دریافت همان گزینش است با نتیجه‌ی ok، و گزینش فرستادن منتظر نخستین کانال دارای جا در بردار می‌ماند و شماره‌اش را برمی‌گرداند؛ در پایان مهلت ۱- و وقتی همه بسته باشند ۲-. مهلت صفر میلی‌ثانیه هر کدام را به یک کوشش بدون انتظار تبدیل می‌کند؛ کوشش برای گزینش و کوشش برای گزینش فرستادن همان کار را با صفر آماده انجام می‌دهند.

تخلیه و برداشتن مثل دریافت صبر می‌کنند، پس کانال را پیش از تخلیه ببندید و بیشتر از مقدارهایی که می‌رسند درخواست نکنید. گزینش فرستادن فقط به کانال دارای بافر و جا می‌فرستد: در کانال بی‌بافر تلاش برای فرستادن همیشه نادرست است، پس به آن بافر بدهید یا از یک نخ با فرستادن استفاده کنید.

گونه‌ها

کانال Chan

ساختار کانال<T>
کانالی از مقدارهای گونه‌ی T.
نامانگلیسیگونهتوضیح
بافرbufT*بافر مقدارها.
وضعیت درونیctlصحیح۶۴*وضعیت درونی: سر و ته صف، تعداد و بسته بودن.
اندازه بافرcapصحیح۶۴ = 0ظرفیت.
خانه صفرzidxصحیح۶۴ = 0خانه‌ای از بافر که مقدار صفر گونه را نگه می‌دارد، برای وقتی چیزی دریافت نشد.
قفلmuهمگام سازی.قفلقفل درونی.
شرط ناخالیnot_emptyهمگام سازی.متغیر شرطبیدار کردن گیرنده‌ها.
شرط ناپرnot_fullهمگام سازی.متغیر شرطبیدار کردن فرستنده‌ها.
شرط برداشتtakenهمگام سازی.متغیر شرطخبر برداشتن مقدار در کانال بی‌بافر.
chan-Chan.salam
واردسازی کانال
واردسازی همگام سازی

ناپایا کارها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا نتیجه‌ها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا گروه := همگام سازی.گروه انتظار {}

تابع کارگر():
    ناپایا باز := درست
    تا درست:
        ع := کارها.دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        نتیجه‌ها.فرستادن(ع * ع)
    پایان
    همگام سازی.اتمام(گروه)
پایان

تابع ریشه:
    کارها.مقداردهی(۴)
    نتیجه‌ها.مقداردهی(۱۶)
    گروه = همگام سازی.گروه انتظار جدید()
    همگام سازی.افزودن(گروه، ۲)
    الف := نخ‌ساز(کارگر)
    ب := نخ‌ساز(کارگر)
    تکرار ۱ تا ۱۱ در ع:
        کارها.فرستادن(ع)
    پایان
    کارها.بستن()
    همگام سازی.انتظار(گروه)
    نخ‌پیوند(الف)
    نخ‌پیوند(ب)
    نتیجه‌ها.بستن()
    ناپایا جمع := ۰ برگردان صحیح۶۴
    ناپایا باز := درست
    تا درست:
        م := نتیجه‌ها.دریافت(باز)
        اگر وارونه باز:
            بشکن
        پایان
        جمع += م
    پایان
    سرچاپ "جمع مربع‌ها:"، جمع
    سرچاپ کارها.بسته است()، کارها.طول()، کارها.ظرفیت()، کارها.فرستادن(۱)
    همگام سازی.نابودسازی گروه انتظار(گروه)
    کارها.آزادسازی()
    نتیجه‌ها.آزادسازی()
پایان
خروجیجمع مربع‌ها: 506 true 0 4 false

مقداردهی Init

تابع مقداردهی(capacity: صحیح۶۴)

مقداردهی init

تابع مقداردهی(capacity: صحیح۶۴)
کانال را با ظرفیت داده‌شده آماده می‌کند؛ صفر یعنی بی‌میان‌گیر. یک بار و پیش از آن‌که نخی از کانال استفاده کند صدایش بزنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

فرستادن Send

تابع فرستادن(v: T): منطقی

فرستادن send

تابع فرستادن(v: T): منطقی
مقداری را می‌فرستد و اگر جا نباشد صبر می‌کند؛ در کانال بی‌میان‌گیر تا وقتی گیرنده آن را بردارد صبر می‌کند. اگر کانال بسته باشد، یا هنگام انتظار بسته شود، نادرست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

فرستادن با مهلت SendTimeout

تابع فرستادن با مهلت(v: T، ms: صحیح۶۴): منطقی

فرستادن با مهلت send_timeout

تابع فرستادن با مهلت(v: T، ms: صحیح۶۴): منطقی
مثل فرستادن، ولی حداکثر ms میلی‌ثانیه صبر می‌کند.
chan-Timeout.salam
واردسازی کانال

تابع ریشه:
    ناپایا ک := کانال.کانال {} برگردان کانال.کانال<رشته>
    ک.مقداردهی(۱)
    سرچاپ ک.کوشش برای فرستادن("سلام")، ک.کوشش برای فرستادن("دوباره")
    سرچاپ ک.فرستادن با مهلت("دیر"، ۲۰)
    ناپایا باز := درست
    سرچاپ ک.کوشش برای دریافت(باز)، باز
    _ := ک.دریافت با مهلت(باز، ۲۰)
    سرچاپ "پس از ۲۰ میلی‌ثانیه:"، باز
    سرچاپ ک.فرستادن با موعد("الف"، ۰، نادرست)
    سرچاپ ک.دریافت با موعد(باز، ۲۰، درست)، باز
    ک.آزادسازی()
پایان
خروجیtrue false false سلام true پس از ۲۰ میلی‌ثانیه: false true الف true

فرستادن با موعد SendDeadline

تابع فرستادن با موعد(v: T، ms: صحیح۶۴، timed: منطقی): منطقی

فرستادن با موعد send_deadline

تابع فرستادن با موعد(v: T، ms: صحیح۶۴، timed: منطقی): منطقی
پایه‌ی دو تابع بالا: اگر timed درست باشد، تا ms میلی‌ثانیه صبر می‌کند و وگرنه بی‌پایان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam

دریافت Recv

تابع دریافت(ok &: منطقی): T

دریافت recv

تابع دریافت(ok &: منطقی): T
یک مقدار دریافت می‌کند و اگر چیزی نباشد صبر می‌کند. اگر کانال بسته و خالی باشد، ok نادرست می‌شود؛ در این حالت مقدار برگشتی معنایی ندارد و نباید به کارش ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

دریافت با مهلت RecvTimeout

تابع دریافت با مهلت(ok &: منطقی، ms: صحیح۶۴): T

دریافت با مهلت recv_timeout

تابع دریافت با مهلت(ok &: منطقی، ms: صحیح۶۴): T
مثل دریافت، ولی حداکثر ms میلی‌ثانیه صبر می‌کند. اگر چیزی نرسد، ok نادرست می‌شود؛ بسته است پایان مهلت را از کانال بسته جدا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam

دریافت با موعد RecvDeadline

تابع دریافت با موعد(ok &: منطقی، ms: صحیح۶۴، timed: منطقی): T

دریافت با موعد recv_deadline

تابع دریافت با موعد(ok &: منطقی، ms: صحیح۶۴، timed: منطقی): T
پایه‌ی دو تابع بالا، با همان معنای timed.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam

کوشش برای فرستادن TrySend

تابع کوشش برای فرستادن(v: T): منطقی

کوشش برای فرستادن try_send

تابع کوشش برای فرستادن(v: T): منطقی
اگر فوراً جا باشد می‌فرستد؛ صبر نمی‌کند. در کانال بی‌بافر همیشه نادرست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam

کوشش برای دریافت TryRecv

تابع کوشش برای دریافت(ok &: منطقی): T

کوشش برای دریافت try_recv

تابع کوشش برای دریافت(ok &: منطقی): T
اگر فوراً مقداری باشد دریافت می‌کند و ok را درست می‌کند؛ صبر نمی‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam

بستن Close

تابع بستن()

بستن close

تابع بستن()
کانال را می‌بندد و همه‌ی نخ‌های منتظر را بیدار می‌کند. مقدارهایی که در میان‌گیر مانده‌اند هنوز دریافت‌شدنی‌اند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

بسته است IsClosed

تابع بسته است(): منطقی

بسته است is_closed

تابع بسته است(): منطقی
آیا کانال بسته شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

طول Len

تابع طول(): صحیح۶۴

طول len

تابع طول(): صحیح۶۴
تعداد مقدارهای منتظر در بافر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

ظرفیت Capacity

تابع ظرفیت(): صحیح۶۴

ظرفیت capacity

تابع ظرفیت(): صحیح۶۴
ظرفیت کانال.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

آزادسازی Free

تابع آزادسازی()

آزادسازی free

تابع آزادسازی()
حافظه‌ی کانال را آزاد می‌کند. پس از پیوستن همه‌ی نخ‌هایی که از کانال استفاده می‌کنند صدایش بزنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Chan.salam

زمان‌سنج Timer

ساختار زمان‌سنج
زمان‌سنجی که کانال کانال آن هنگام فعال شدن مقداری دریافت می‌کند.
نامانگلیسیگونهتوضیح
کانالcکانال<صحیح۶۴>کانالی که هر بار با فعال شدن زمان‌سنج مقداری دریافت می‌کند.
لغوcancelصحیح۶۴*پرچمی که به نخ زمان‌سنج می‌گوید متوقف شود.
آرگومانargتهی*بلوک آرگومان نخ زمان‌سنج.
دستهhandleصحیح۶۴ = 0دسته نخ زمان‌سنج.
chan-Timer.salam
واردسازی کانال

تابع ریشه:
    ناپایا کار := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
    کار.مقداردهی(1 برگردان صحیح۶۴)
    ناپایا متغیر_cs := وکتور {} برگردان وکتور<کانال.کانال<صحیح۶۴>>
    متغیر_cs.بیفزا(کار)
    موقت := کانال.پس از(30 برگردان صحیح۶۴)
    متغیر_cs.بیفزا(موقت.کانال)
    ناپایا مقدار_محلی := 0 برگردان صحیح۶۴
    سرچاپ "timer fired first: "، کانال.گزینش(متغیر_cs، مقدار_محلی، 2000 برگردان صحیح۶۴)
    سرچاپ "tick value: "، مقدار_محلی
    کانال.توقف زمان‌سنج(موقت)

    شمارنده۳ := کانال.ضربان(10 برگردان صحیح۶۴)
    ناپایا موفق := نادرست
    ناپایا دیده := 0
    تا دیده کوچکتر 3:
        شمارنده۳.کانال.دریافت(موفق)
        دیده++
    پایان
    سرچاپ "ticks: "، دیده
    کانال.توقف زمان‌سنج(شمارنده۳)

    متغیر_quick := کانال.پس از(500 برگردان صحیح۶۴)
    کانال.توقف زمان‌سنج(متغیر_quick)
    سرچاپ "stopped early"
    کار.آزادسازی()
پایان
خروجیtimer fired first: 1 tick value: 1 ticks: 3 stopped early

تابع‌ها

جدید New

تابع جدید<T>(capacity: صحیح۶۴): کانال<T>
کانالی با ظرفیت داده‌شده می‌سازد و آماده برمی‌گرداند؛ صفر یعنی بی‌بافر. گونه را روی نتیجه بنویسید، مثل کانال.جدید(4) برگردان کانال.کانال<صحیح۶۴>.
chan-API.salam
// زبان: فارسی
بسته ریشه

واردسازی کانال

تابع ریشه:
    نویسه := کانال.جدید(3) برگردان کانال.کانال<رشته>
    سرچاپ "capacity:"، کانال.ظرفیت(نویسه)، "len:"، کانال.طول(نویسه)

    واژه‌ها := وکتور {} برگردان وکتور<رشته>
    واژه‌ها.بیفزا("one")
    واژه‌ها.بیفزا("two")
    سرچاپ "sent:"، کانال.فرستادن همه(نویسه، واژه‌ها)
    سرچاپ "queued:"، کانال.طول(نویسه)
    واژه‌ها.آزادکن()

    ناپایا موفق := نادرست
    سرچاپ "first:"، کانال.دریافت(نویسه، موفق)، موفق
    سرچاپ "next:"، کانال.کوشش برای دریافت(نویسه، موفق)، موفق
    کانال.بستن(نویسه)
    سرچاپ "closed:"، کانال.بسته است(نویسه)، "send:"، کانال.کوشش برای فرستادن(نویسه، "late")

    چپ := کانال.تخلیه(نویسه)
    سرچاپ "left:"، چپ.طول()
    چپ.آزادکن()
    نویسه.آزادسازی()
پایان
خروجیcapacity: 3 len: 0 sent: true queued: 2 first: one true next: two true closed: true send: false left: 0

فرستادن Send

تابع فرستادن<T>(c: کانال<T>، v: T): منطقی
شکل تابع آزاد فرستادن: مقدار را می‌فرستد و برای جا صبر می‌کند و اگر کانال بسته باشد نادرست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

فرستادن با مهلت SendTimeout

تابع فرستادن با مهلت<T>(c: کانال<T>، v: T، ms: صحیح۶۴): منطقی
شکل تابع آزاد فرستادن با مهلت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

کوشش برای فرستادن TrySend

تابع کوشش برای فرستادن<T>(c: کانال<T>، v: T): منطقی
شکل تابع آزاد تلاش برای فرستادن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

فرستادن همه SendAll

تابع فرستادن همه<T>(c: کانال<T>، values: وکتور<T>): منطقی
همه‌ی مقدارهای وکتور را به ترتیب می‌فرستد و با نخستین شکست نادرست برمی‌گرداند؛ مقدارهای بعد از آن فرستاده نشده‌اند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

دریافت Recv

تابع دریافت<T>(c: کانال<T>، ok &: منطقی): T
شکل تابع آزاد دریافت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

دریافت با مهلت RecvTimeout

تابع دریافت با مهلت<T>(c: کانال<T>، ok &: منطقی، ms: صحیح۶۴): T
شکل تابع آزاد دریافت با مهلت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

کوشش برای دریافت TryRecv

تابع کوشش برای دریافت<T>(c: کانال<T>، ok &: منطقی): T
شکل تابع آزاد تلاش برای دریافت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

تخلیه Drain

تابع تخلیه<T>(c: کانال<T>): وکتور<T>
مقدارها را تا بسته و خالی شدن کانال دریافت می‌کند و به شکل وکتور برمی‌گرداند. مثل دریافت صبر می‌کند، پس پیش از صدا زدنش کانال را ببندید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

برداشتن Take

تابع برداشتن<T>(c: کانال<T>، n: صحیح۶۴): وکتور<T>
حداکثر n مقدار دریافت می‌کند و به شکل وکتور برمی‌گرداند؛ وقتی کانال بسته و خالی شود زودتر می‌ایستد و در غیر این صورت صبر می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

بستن Close

تابع بستن<T>(c: کانال<T>)
شکل تابع آزاد بستن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

طول Len

تابع طول<T>(c: کانال<T>): صحیح۶۴
شکل تابع آزاد طول.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

ظرفیت Capacity

تابع ظرفیت<T>(c: کانال<T>): صحیح۶۴
شکل تابع آزاد ظرفیت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

بسته است IsClosed

تابع بسته است<T>(c: کانال<T>): منطقی
شکل تابع آزاد بسته است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

پس از After

تابع پس از(ms: صحیح۶۴): زمان‌سنج
زمان‌سنجی که پس از ms میلی‌ثانیه یک بار می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timer.salam

ضربان Tick

تابع ضربان(ms: صحیح۶۴): زمان‌سنج
زمان‌سنجی که هر ms میلی‌ثانیه می‌فرستد تا متوقف شود. اگر کانال پر باشد آن ضربان دور ریخته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timer.salam

توقف زمان‌سنج StopTimer

تابع توقف زمان‌سنج(t: زمان‌سنج)
زمان‌سنج را متوقف می‌کند، به نخش می‌پیوندد و آزادش می‌کند. برای هر زمان‌سنج یک بار صدا بزنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-Timer.salam

گزینش Select

تابع گزینش<T>(cs: وکتور<کانال<T>>، v &: T، ms: صحیح۶۴): صحیح۶۴
بی‌پرسش‌های پیاپی منتظر اولین کانال آماده در یک بردار از کانال‌ها می‌ماند: تا وقتی فرستادن یا بستنی بیدارش کند می‌خوابد. شماره‌ی آن را برمی‌گرداند و مقدار را در ورودی می‌گذارد؛ ۱- وقتی مهلت بر حسب میلی‌ثانیه تمام شود (مهلت منفی یعنی تا همیشه صبر)، و ۲- وقتی همه‌ی کانال‌ها بسته و خالی باشند.
chan-Select.salam
واردسازی کانال
واردسازی استخر

تابع ریشه:
    ناپایا الف := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
    ناپایا بافر_محلی := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
    الف.مقداردهی(2 برگردان صحیح۶۴)
    بافر_محلی.مقداردهی(2 برگردان صحیح۶۴)
    ناپایا متغیر_all := وکتور {} برگردان وکتور<کانال.کانال<صحیح۶۴>>
    متغیر_all.بیفزا(الف)
    متغیر_all.بیفزا(بافر_محلی)
    ویژگی_محلی := استخر.جدید(1 برگردان صحیح۶۴، 2 برگردان صحیح۶۴)
    استخر.ارسال(ویژگی_محلی، (): بافر_محلی.فرستادن(42 برگردان صحیح۶۴) پایان)
    ناپایا مقدار_محلی := 0 برگردان صحیح۶۴
    سرچاپ کانال.گزینش(متغیر_all، مقدار_محلی، 1000 برگردان صحیح۶۴)
    سرچاپ مقدار_محلی
    سرچاپ کانال.گزینش(متغیر_all، مقدار_محلی، 10 برگردان صحیح۶۴)
    الف.بستن()
    بافر_محلی.بستن()
    سرچاپ کانال.گزینش(متغیر_all، مقدار_محلی، 10 برگردان صحیح۶۴)
    استخر.توقف(ویژگی_محلی)
    الف.آزادسازی()
    بافر_محلی.آزادسازی()
پایان
خروجی1 42 -1 -2

گزینش دریافت SelectRecv

تابع گزینش دریافت<T>(cs: وکتور<کانال<T>>، v &: T، ok &: منطقی، ms: صحیح۶۴): صحیح۶۴
گزینش با نتیجه‌ی دوم: ok وقتی مقداری رسیده درست است و در پایان مهلت یا وقتی همه‌ی کانال‌ها بسته و خالی‌اند نادرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

کوشش برای گزینش TrySelect

تابع کوشش برای گزینش<T>(cs: وکتور<کانال<T>>، v &: T): صحیح۶۴
یک گزینش بدون انتظار: شماره‌ی کانال آماده را برمی‌گرداند، یا اگر اکنون هیچ‌کدام آماده نباشد ۱-.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

گزینش فرستادن SelectSend

تابع گزینش فرستادن<T>(cs: وکتور<کانال<T>>، v: T، ms: صحیح۶۴): صحیح۶۴
مقدار را به نخستین کانال دارای جا در بردار می‌فرستد، بدون پرسش پیاپی، و شماره‌اش را برمی‌گرداند. در پایان مهلت ۱- و وقتی همه بسته باشند ۲- برمی‌گرداند. روی کانال دارای بافر کار می‌کند؛ کانال بی‌بافر برای تلاش برای فرستادن هرگز جا ندارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam

کوشش برای گزینش فرستادن TrySelectSend

تابع کوشش برای گزینش فرستادن<T>(cs: وکتور<کانال<T>>، v: T): صحیح۶۴
یک گزینش فرستادن بدون انتظار: شماره‌ی کانالی که مقدار را گرفت، یا اگر اکنون هیچ کانالی جا نداشته باشد ۱-.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: chan-API.salam