کانال chan
کانال برای فرستادن مقدار از یک نخ به نخ دیگر، با بافر، مهلت و بستن.
واردسازی کانال
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
کانال صفی است که چند نخ از یک سر آن مقدار میفرستند و از سر دیگر دریافت میکنند؛ قفلها و انتظارها را خودش مدیریت میکند. گونهی مقدارها را هنگام ساختن میگویید، مثل کانال.کانال<صحیح۶۴>، و پیش از استفاده مقداردهی را با ظرفیت صدا میزنید.
اگر بافر پر باشد، فرستادن صبر میکند؛ اگر خالی باشد، دریافت. کانال با ظرفیت صفر «بیبافر» است: فرستنده تا وقتی گیرنده مقدار را برندارد صبر میکند. پس از بستن، فرستادن نادرست برمیگرداند ولی گیرندهها هنوز مقدارهای مانده را میگیرند؛ وقتی کانال خالی شد، باز نادرست میشود و حلقهی گیرنده میتواند تمام شود.
کانال را وقتی به کار ببرید که یک نخ مقدار تولید میکند و نخ دیگری مصرفش میکند. برای دادهی مشترکی که چند نخ درجا تغییرش میدهند، همگام سازی مناسبتر است؛ برای یک شمارنده، اتمی؛ برای اجرای دورهای یک حلقه روی همهی هستهها، استخر؛ و برای گفتن به کارگرها که بایستند، زمینه.
اشتباههای رایج:
- فراموش کردن
مقداردهی. کانالی که باکانال.کانال {}تعریف شده هنوز میانگیر و قفلی ندارد و با نخستینفرستادنبرنامه را از کار میاندازد. - به کار بردن مقدار یک دریافت ناموفق. وقتی
بازنادرست است، نتیجه یک مقدار صفر بیمعناست. - جدا نکردن پایان مهلت از پایان کار.
دریافت با مهلتهم وقتی زمان تمام شده و هم وقتی کانال بسته و خالی استبازرا نادرست میکند؛ برای فهمیدن اینکه کدام بوده،بسته استرا بپرسید. - فرستادن یک
وکتوریا اشارهگر و سپس تغییر دادنش. کانال مقدار را رونوشت میکند، که برای این گونهها فقط دسته است؛ پس هر دو نخ همان حافظه را میبینند.
حلقهی دریافت
تقریباً همهی مصرفکنندهها یک شکل دارند: در یک حلقهی بیپایان تا درست: دریافت میکنند و وقتی باز نادرست شد بشکن میزنند. این فقط وقتی پیش میآید که کانال بسته و خالی باشد، پس هیچ مقداری گم نمیشود. قاعدهای که با آن همراه است: طرفی که میفرستد همان طرفی است که میبندد، وقتی دیگر چیزی برای فرستادن ندارد.
واردسازی کانال
ناپایا سفارشها := کانال.کانال {} برگردان کانال.کانال<رشته>
تابع پرداخت():
هر شناسه در ["A-1001"، "A-1002"، "A-1003"]:
سفارشها.فرستادن(شناسه)
پایان
سفارشها.بستن()
سرچاپ "پس از بستن، فرستادن کار میکند:"، سفارشها.فرستادن("A-1004")
پایان
تابع ریشه:
سفارشها.مقداردهی(۸)
ن := نخساز(پرداخت)
نخپیوند(ن)
سرچاپ "منتظر در میانگیر:"، سفارشها.طول()
ناپایا باز := درست
تا درست:
شناسه := سفارشها.دریافت(باز)
اگر وارونه باز: بشکن پایان
سرچاپ "بستهبندی"، شناسه
پایان
سرچاپ "بسته و خالی:"، سفارشها.بسته است()، سفارشها.طول()
سفارشها.آزادسازی()
پایانفرستنده پیش از آنکه گیرنده حتی شروع کند میانگیر را پر کرد و کانال را بست، و باز هم همهی سفارشها بیرون آمدند. فرستادن پس از بستن بهجای صبر کردن نادرست برمیگرداند.
خط لولهای از مرحلهها
کانالها مرحلههایی را به هم وصل میکنند که هر کدام یک کار میکنند. اینجا یک نخ عدد میسازد، نخ دوم آنها را به توان دو میرساند و نخ اصلی جمعشان میکند. هر مرحله وقتی ورودیاش تمام شد کانال خروجیاش را میبندد، پس پایان داده خودبهخود در خط لوله پایین میرود و هر حلقه خودش میایستد.
واردسازی کانال
ناپایا عددها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا مربعها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
تابع تولید():
تکرار ۱ تا ۱۰ در ع:
عددها.فرستادن(ع برگردان صحیح۶۴)
پایان
عددها.بستن()
پایان
تابع مربع کردن():
ناپایا باز := درست
تا درست:
ع := عددها.دریافت(باز)
اگر وارونه باز:
بشکن
پایان
مربعها.فرستادن(ع * ع)
پایان
مربعها.بستن()
پایان
تابع ریشه:
عددها.مقداردهی(۲)
مربعها.مقداردهی(۲)
الف := نخساز(تولید)
ب := نخساز(مربع کردن)
ناپایا جمع := ۰ برگردان صحیح۶۴
ناپایا شمار := ۰
ناپایا باز := درست
تا درست:
م := مربعها.دریافت(باز)
اگر وارونه باز:
بشکن
پایان
جمع += م
شمار++
پایان
نخپیوند(الف)
نخپیوند(ب)
سرچاپ "مقدارهایی که از خط لوله گذشتند:"، شمار
سرچاپ "جمع مربعها:"، جمع
عددها.آزادسازی()
مربعها.آزادسازی()
پایانهر کانال فقط دو مقدار جا دارد. وقتی مرحلهی آخر کند است، مرحلههای قبلی در فرستادن منتظر میمانند و حافظه را پر نمیکنند؛ به این «فشار برگشتی» میگویند.
پرسیدن و منتظر پاسخ ماندن
دو کانال یک جفت درخواست و پاسخ میسازند: یکی پرسشها را به کارگر میبرد و دیگری پاسخها را برمیگرداند. با ظرفیت صفر، هر فرستادن صبر میکند تا طرف دیگر مقدار را بگیرد، پس دو نخ همقدم پیش میروند و پاسخها به همان ترتیبی برمیگردند که پرسشها رفته بودند.
واردسازی کانال
ناپایا درخواستها := کانال.کانال {} برگردان کانال.کانال<رشته>
ناپایا پاسخها := کانال.کانال {} برگردان کانال.کانال<رشته>
تابع کارساز():
ناپایا باز := درست
تا درست:
نام := درخواستها.دریافت(باز)
اگر وارونه باز:
بشکن
پایان
پاسخها.فرستادن("سلام، " + نام)
پایان
پایان
تابع ریشه:
درخواستها.مقداردهی(۰)
پاسخها.مقداردهی(۰)
ن := نخساز(کارساز)
ناپایا باز := درست
هر نام در ["سارا"، "رضا"، "مینا"]:
درخواستها.فرستادن(نام)
سرچاپ پاسخها.دریافت(باز)
پایان
درخواستها.بستن()
نخپیوند(ن)
درخواستها.آزادسازی()
پاسخها.آزادسازی()
پایانچند فرستنده، یک گیرنده
وقتی چند نخ در یک کانال میفرستند، هیچکدام نمیتواند آن را ببندد، چون هر کدام فقط میداند که خودش تمام کرده است. فرستندهها را با یک همگام سازی.گروه انتظار بشمارید و یک نخ کوچک دیگر بگذارید که منتظر گروه بماند و بعد کانال را ببندد.
واردسازی کانال
واردسازی همگام سازی
ناپایا رویدادها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا فرستندهها := همگام سازی.گروه انتظار {}
تابع حسگر(پایه: صحیح۶۴):
تکرار ۵ در ای:
رویدادها.فرستادن(پایه + ای برگردان صحیح۶۴)
پایان
همگام سازی.اتمام(فرستندهها)
پایان
تابع حسگر الف(): حسگر(۱۰۰) پایان
تابع حسگر ب(): حسگر(۲۰۰) پایان
تابع حسگر پ(): حسگر(۳۰۰) پایان
تابع بندنده():
همگام سازی.انتظار(فرستندهها)
رویدادها.بستن()
پایان
تابع ریشه:
رویدادها.مقداردهی(۴)
فرستندهها = همگام سازی.گروه انتظار جدید()
همگام سازی.افزودن(فرستندهها، ۳)
الف := نخساز(حسگر الف)
ب := نخساز(حسگر ب)
پ := نخساز(حسگر پ)
ت := نخساز(بندنده)
ناپایا سهم حسگرها := [۰، ۰، ۰]
ناپایا باز := درست
تا درست:
م := رویدادها.دریافت(باز)
اگر وارونه باز:
بشکن
پایان
سهم حسگرها[م / ۱۰۰ - ۱]++
پایان
نخپیوند(الف)
نخپیوند(ب)
نخپیوند(پ)
نخپیوند(ت)
سرچاپ "از حسگر الف:"، سهم حسگرها[۰]
سرچاپ "از حسگر ب:"، سهم حسگرها[۱]
سرچاپ "از حسگر پ:"، سهم حسگرها[۲]
همگام سازی.نابودسازی گروه انتظار(فرستندهها)
رویدادها.آزادسازی()
پایانمقدارهای فرستندههای مختلف بیترتیب مشخصی در هم میرسند، برای همین برنامه آنها را برای هر فرستنده میشمارد و همزمان با رسیدن چاپشان نمیکند.
وقتی کانال پر است
فرستادن منتظر جا میماند و این همیشه آن چیزی نیست که میخواهید. کارسازی که زیر بار است اغلب بهتر است کار اضافه را همان لحظه رد کند تا اینکه همهی درخواستکنندهها را منتظر بگذارد. تلاش برای فرستادن وقتی جا نیست بیدرنگ نادرست برمیگرداند و تلاش برای دریافت همین کار را برای کانال خالی میکند.
واردسازی کانال
تابع ریشه:
ناپایا صف := کانال.کانال {} برگردان کانال.کانال<صحیح>
صف.مقداردهی(۳)
ناپایا پذیرفته := ۰
ناپایا کنارگذاشته := ۰
تکرار ۱ تا ۸ در درخواست:
اگر صف.کوشش برای فرستادن(درخواست):
پذیرفته++
وگرنه:
کنارگذاشته++
پایان
پایان
سرچاپ "پذیرفته:"، پذیرفته، "کنار گذاشته:"، کنارگذاشته، "در انتظار:"، صف.طول()
ناپایا باز := درست
تا درست:
د := صف.کوشش برای دریافت(باز)
اگر وارونه باز:
بشکن
پایان
سرچاپ "رسیدگی به درخواست"، د
پایان
سرچاپ "صف خالی است:"، صف.طول() == ۰
صف.آزادسازی()
پایانمیان این دو، فرستادن با مهلت و دریافت با مهلت هستند که حداکثر به اندازهی میلیثانیههای دادهشده صبر میکنند.
| اگر کانال پر یا خالی باشد | فرستادن | دریافت |
|---|---|---|
| هر قدر لازم است صبر کن | فرستادن | دریافت |
| حداکثر چند میلیثانیه صبر کن | فرستادن با مهلت | دریافت با مهلت |
| اصلاً صبر نکن | تلاش برای فرستادن | تلاش برای دریافت |
دو اشتباه را نکنید: دریافت از کانالی که هیچکس نه در آن میفرستد و نه آن را میبندد برای همیشه منتظر میماند، و صدا زدن آزادسازی وقتی نخ دیگری هنوز از کانال استفاده میکند. اول به نخها بپیوندید، بعد آزاد کنید.
راه کوتاهتر
جدید کانال آماده میسازد، پس تنها چیز اضافه، برگردان گونه است: نویسه := کانال.جدید(8) برگردان کانال.کانال<صحیح۶۴>. تابعهای آزاد فرستادن، دریافت، کوشش برای فرستادن، کوشش برای دریافت، بستن، طول، ظرفیت و بسته است کانال را نخستین آرگومان میگیرند و همان کار متد همنام را میکنند. فرستادن همه یک وکتور کامل را میفرستد و با نخستین شکست میایستد؛ برداشتن حداکثر تعدادی را دریافت میکند؛ و تخلیه هر چه مانده را تا بسته و خالی شدن کانال دریافت میکند.
// زبان: فارسی
بسته ریشه
واردسازی کانال
تابع ریشه:
نویسه := کانال.جدید(3) برگردان کانال.کانال<رشته>
سرچاپ "capacity:"، کانال.ظرفیت(نویسه)، "len:"، کانال.طول(نویسه)
واژهها := وکتور {} برگردان وکتور<رشته>
واژهها.بیفزا("one")
واژهها.بیفزا("two")
سرچاپ "sent:"، کانال.فرستادن همه(نویسه، واژهها)
سرچاپ "queued:"، کانال.طول(نویسه)
واژهها.آزادکن()
ناپایا موفق := نادرست
سرچاپ "first:"، کانال.دریافت(نویسه، موفق)، موفق
سرچاپ "next:"، کانال.کوشش برای دریافت(نویسه، موفق)، موفق
کانال.بستن(نویسه)
سرچاپ "closed:"، کانال.بسته است(نویسه)، "send:"، کانال.کوشش برای فرستادن(نویسه، "late")
چپ := کانال.تخلیه(نویسه)
سرچاپ "left:"، چپ.طول()
چپ.آزادکن()
نویسه.آزادسازی()
پایانگزینش دریافت همان گزینش است با نتیجهی ok، و گزینش فرستادن منتظر نخستین کانال دارای جا در بردار میماند و شمارهاش را برمیگرداند؛ در پایان مهلت ۱- و وقتی همه بسته باشند ۲-. مهلت صفر میلیثانیه هر کدام را به یک کوشش بدون انتظار تبدیل میکند؛ کوشش برای گزینش و کوشش برای گزینش فرستادن همان کار را با صفر آماده انجام میدهند.
تخلیه و برداشتن مثل دریافت صبر میکنند، پس کانال را پیش از تخلیه ببندید و بیشتر از مقدارهایی که میرسند درخواست نکنید. گزینش فرستادن فقط به کانال دارای بافر و جا میفرستد: در کانال بیبافر تلاش برای فرستادن همیشه نادرست است، پس به آن بافر بدهید یا از یک نخ با فرستادن استفاده کنید.
گونهها
کانال Chan
ساختار کانال<T>T.| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| بافر | buf | T* | بافر مقدارها. |
| وضعیت درونی | ctl | صحیح۶۴* | وضعیت درونی: سر و ته صف، تعداد و بسته بودن. |
| اندازه بافر | cap | صحیح۶۴ = 0 | ظرفیت. |
| خانه صفر | zidx | صحیح۶۴ = 0 | خانهای از بافر که مقدار صفر گونه را نگه میدارد، برای وقتی چیزی دریافت نشد. |
| قفل | mu | همگام سازی.قفل | قفل درونی. |
| شرط ناخالی | not_empty | همگام سازی.متغیر شرط | بیدار کردن گیرندهها. |
| شرط ناپر | not_full | همگام سازی.متغیر شرط | بیدار کردن فرستندهها. |
| شرط برداشت | taken | همگام سازی.متغیر شرط | خبر برداشتن مقدار در کانال بیبافر. |
واردسازی کانال
واردسازی همگام سازی
ناپایا کارها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا نتیجهها := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا گروه := همگام سازی.گروه انتظار {}
تابع کارگر():
ناپایا باز := درست
تا درست:
ع := کارها.دریافت(باز)
اگر وارونه باز:
بشکن
پایان
نتیجهها.فرستادن(ع * ع)
پایان
همگام سازی.اتمام(گروه)
پایان
تابع ریشه:
کارها.مقداردهی(۴)
نتیجهها.مقداردهی(۱۶)
گروه = همگام سازی.گروه انتظار جدید()
همگام سازی.افزودن(گروه، ۲)
الف := نخساز(کارگر)
ب := نخساز(کارگر)
تکرار ۱ تا ۱۱ در ع:
کارها.فرستادن(ع)
پایان
کارها.بستن()
همگام سازی.انتظار(گروه)
نخپیوند(الف)
نخپیوند(ب)
نتیجهها.بستن()
ناپایا جمع := ۰ برگردان صحیح۶۴
ناپایا باز := درست
تا درست:
م := نتیجهها.دریافت(باز)
اگر وارونه باز:
بشکن
پایان
جمع += م
پایان
سرچاپ "جمع مربعها:"، جمع
سرچاپ کارها.بسته است()، کارها.طول()، کارها.ظرفیت()، کارها.فرستادن(۱)
همگام سازی.نابودسازی گروه انتظار(گروه)
کارها.آزادسازی()
نتیجهها.آزادسازی()
پایانمقداردهی 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 میلیثانیه صبر میکند.واردسازی کانال
تابع ریشه:
ناپایا ک := کانال.کانال {} برگردان کانال.کانال<رشته>
ک.مقداردهی(۱)
سرچاپ ک.کوشش برای فرستادن("سلام")، ک.کوشش برای فرستادن("دوباره")
سرچاپ ک.فرستادن با مهلت("دیر"، ۲۰)
ناپایا باز := درست
سرچاپ ک.کوشش برای دریافت(باز)، باز
_ := ک.دریافت با مهلت(باز، ۲۰)
سرچاپ "پس از ۲۰ میلیثانیه:"، باز
سرچاپ ک.فرستادن با موعد("الف"، ۰، نادرست)
سرچاپ ک.دریافت با موعد(باز، ۲۰، درست)، باز
ک.آزادسازی()
پایانفرستادن با موعد SendDeadline
تابع فرستادن با موعد(v: T، ms: صحیح۶۴، timed: منطقی): منطقیفرستادن با موعد send_deadline
تابع فرستادن با موعد(v: T، ms: صحیح۶۴، timed: منطقی): منطقیtimed درست باشد، تا ms میلیثانیه صبر میکند و وگرنه بیپایان.نمونهی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam
دریافت Recv
تابع دریافت(ok &: منطقی): Tدریافت recv
تابع دریافت(ok &: منطقی): Tok نادرست میشود؛ در این حالت مقدار برگشتی معنایی ندارد و نباید به کارش ببرید.نمونهی این مورد همراه با موارد بالاتر آمده است: 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: منطقی): Ttimed.نمونهی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam
کوشش برای فرستادن TrySend
تابع کوشش برای فرستادن(v: T): منطقیکوشش برای فرستادن try_send
تابع کوشش برای فرستادن(v: T): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: chan-Timeout.salam
کوشش برای دریافت TryRecv
تابع کوشش برای دریافت(ok &: منطقی): Tکوشش برای دریافت try_recv
تابع کوشش برای دریافت(ok &: منطقی): Tok را درست میکند؛ صبر نمیکند.نمونهی این مورد همراه با موارد بالاتر آمده است: 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 | دسته نخ زمانسنج. |
واردسازی کانال
تابع ریشه:
ناپایا کار := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
کار.مقداردهی(1 برگردان صحیح۶۴)
ناپایا متغیر_cs := وکتور {} برگردان وکتور<کانال.کانال<صحیح۶۴>>
متغیر_cs.بیفزا(کار)
موقت := کانال.پس از(30 برگردان صحیح۶۴)
متغیر_cs.بیفزا(موقت.کانال)
ناپایا مقدار_محلی := 0 برگردان صحیح۶۴
سرچاپ "timer fired first: "، کانال.گزینش(متغیر_cs، مقدار_محلی، 2000 برگردان صحیح۶۴)
سرچاپ "tick value: "، مقدار_محلی
کانال.توقف زمانسنج(موقت)
شمارنده۳ := کانال.ضربان(10 برگردان صحیح۶۴)
ناپایا موفق := نادرست
ناپایا دیده := 0
تا دیده کوچکتر 3:
شمارنده۳.کانال.دریافت(موفق)
دیده++
پایان
سرچاپ "ticks: "، دیده
کانال.توقف زمانسنج(شمارنده۳)
متغیر_quick := کانال.پس از(500 برگردان صحیح۶۴)
کانال.توقف زمانسنج(متغیر_quick)
سرچاپ "stopped early"
کار.آزادسازی()
پایانتابعها
جدید New
تابع جدید<T>(capacity: صحیح۶۴): کانال<T>کانال.جدید(4) برگردان کانال.کانال<صحیح۶۴>.// زبان: فارسی
بسته ریشه
واردسازی کانال
تابع ریشه:
نویسه := کانال.جدید(3) برگردان کانال.کانال<رشته>
سرچاپ "capacity:"، کانال.ظرفیت(نویسه)، "len:"، کانال.طول(نویسه)
واژهها := وکتور {} برگردان وکتور<رشته>
واژهها.بیفزا("one")
واژهها.بیفزا("two")
سرچاپ "sent:"، کانال.فرستادن همه(نویسه، واژهها)
سرچاپ "queued:"، کانال.طول(نویسه)
واژهها.آزادکن()
ناپایا موفق := نادرست
سرچاپ "first:"، کانال.دریافت(نویسه، موفق)، موفق
سرچاپ "next:"، کانال.کوشش برای دریافت(نویسه، موفق)، موفق
کانال.بستن(نویسه)
سرچاپ "closed:"، کانال.بسته است(نویسه)، "send:"، کانال.کوشش برای فرستادن(نویسه، "late")
چپ := کانال.تخلیه(نویسه)
سرچاپ "left:"، چپ.طول()
چپ.آزادکن()
نویسه.آزادسازی()
پایانفرستادن 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: صحیح۶۴): صحیح۶۴واردسازی کانال
واردسازی استخر
تابع ریشه:
ناپایا الف := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
ناپایا بافر_محلی := کانال.کانال {} برگردان کانال.کانال<صحیح۶۴>
الف.مقداردهی(2 برگردان صحیح۶۴)
بافر_محلی.مقداردهی(2 برگردان صحیح۶۴)
ناپایا متغیر_all := وکتور {} برگردان وکتور<کانال.کانال<صحیح۶۴>>
متغیر_all.بیفزا(الف)
متغیر_all.بیفزا(بافر_محلی)
ویژگی_محلی := استخر.جدید(1 برگردان صحیح۶۴، 2 برگردان صحیح۶۴)
استخر.ارسال(ویژگی_محلی، (): بافر_محلی.فرستادن(42 برگردان صحیح۶۴) پایان)
ناپایا مقدار_محلی := 0 برگردان صحیح۶۴
سرچاپ کانال.گزینش(متغیر_all، مقدار_محلی، 1000 برگردان صحیح۶۴)
سرچاپ مقدار_محلی
سرچاپ کانال.گزینش(متغیر_all، مقدار_محلی، 10 برگردان صحیح۶۴)
الف.بستن()
بافر_محلی.بستن()
سرچاپ کانال.گزینش(متغیر_all، مقدار_محلی، 10 برگردان صحیح۶۴)
استخر.توقف(ویژگی_محلی)
الف.آزادسازی()
بافر_محلی.آزادسازی()
پایانگزینش دریافت 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