بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 26: یک تابع برای همه‌ی نوع‌ها A Function for Every Type

می‌بینی که برای عدد و متن مجبوری یک تابع را دو بار بنویسی. بعد با <T> یک تابع جنریک می‌سازی: یک تابع که با هر نوعی کار می‌کند و باز هم نوع را گم نمی‌کند.

در این جلسه یاد می‌گیری

درس

سارا تابعی نوشته که اولین خانه‌ی یک لیست را می‌دهد. برای لیست عددها firstNumber را نوشت. بعد برای لیست اسم‌ها مجبور شد firstText را هم بنویسد. به این دو تابع نگاه کن: داخلشان دقیقاً یکی است. فقط نوع‌ها فرق دارند. فردا برای boolean هم یکی دیگر؟ این کار تکراری است، و هر جا کپی باشد، اشتباه هم هست.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function firstNumber(list: number[]): number {
  return list[0];
}

function firstText(list: string[]): string {
  return list[0];
}

show(firstNumber([7, 8, 9]));
show(firstText(["Sara", "Ali"]));
</script>

شاید بگویی: «خب، نوع را any می‌گذارم تا همه چیز را قبول کند»: function first(list: any[]): any. یادت هست در جلسه‌ی ۴ چه شد؟ any یعنی کلید خاموش. تابع کار می‌کند، ولی جوابش دیگر نوع ندارد. تایپ‌اسکریپت نمی‌داند چیزی که برگشته عدد است یا متن، پس اگر روی یک عدد .toUpperCase() صدا بزنی، هیچ خط قرمزی نمی‌بینی و برنامه وسط اجرا می‌شکند. برای همین any در این دوره خط قرمز است. ما چیز بهتری می‌خواهیم: تابعی که همه‌ی نوع‌ها را قبول کند، ولی یادش بماند چه نوعی گرفته است.

یک جعبه‌ی مقوایی را تصور کن که رویش یک برچسب خالی چسبانده‌اند. هر وقت چیزی داخلش گذاشتی، روی برچسب می‌نویسی چه چیزی است: «کتاب» یا «اسباب‌بازی». در تایپ‌اسکریپت این برچسب خالی را بین < و > می‌نویسیم و معمولاً اسمش را T می‌گذاریم. این تابع را ببین: <T> بعد از اسم تابع یعنی «این تابع یک برچسب خالی به اسم T دارد». اجرا کن: همین یک تابع هم با عدد کار می‌کند، هم با متن.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function first<T>(list: T[]): T {
  return list[0];
}

show(first([7, 8, 9]));
show(first(["Sara", "Ali"]));
</script>

خط اول را آرام بخوان. list: T[] یعنی «ورودی، لیستی از T است». : T در آخر یعنی «جواب هم یک T است». پس اگر لیستِ عدد بدهی، T می‌شود number و جواب هم number است. اگر لیستِ متن بدهی، T می‌شود string. تو لازم نیست چیزی بگویی: تایپ‌اسکریپت به ورودی نگاه می‌کند و خودش برچسب را پُر می‌کند. به این تابع می‌گویند تابع جنریک (generic).

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function first<T>(list: T[]): T {
  return list[0];
}

const best: number = first([7, 8, 9]);
const name: string = first(["Sara", "Ali"]);
show(best + 1);
show(name.toUpperCase());
</script>

فرق جنریک با any همین‌جاست. این‌جا لیستِ اسم داده‌ایم، پس جواب string است. ولی آن را در جعبه‌ای با نوع number گذاشته‌ایم. اجرا کن: خط قرمز. تایپ‌اسکریپت یادش مانده که T این بار string است. با any این اشتباه بی‌صدا رد می‌شد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function first<T>(list: T[]): T {
  return list[0];
}

const best: number = first(["Sara", "Ali"]);
show(best + 1);
</script>

T را هر جای تابع که لازم باشد می‌شود نوشت. این تابع یک چیز می‌گیرد و لیستی می‌سازد که آن چیز چند بار در آن آمده است. ورودی item از نوع T است و جواب T[]، یعنی لیستی از همان نوع. داخل تابع هم const list: T[] = []; نوشته‌ایم. همه‌جا همان یک برچسب است.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function repeat<T>(item: T, times: number): T[] {
  const list: T[] = [];
  for (let i = 0; i < times; i++) {
    list.push(item);
  }
  return list;
}

show(repeat("ha", 3).join(" "));
show(repeat(5, 4).length);
</script>

اگر بخواهی، خودت هم می‌توانی برچسب را پُر کنی: first<string>(["Sara", "Ali"]). نوع را بین < و >، درست قبل از پرانتز می‌نویسی. بیشتر وقت‌ها لازم نیست، چون تایپ‌اسکریپت خودش حدس می‌زند. ولی خوب است بدانی این دو خط یک معنی دارند.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function first<T>(list: T[]): T {
  return list[0];
}

show(first<string>(["Sara", "Ali"]));
show(first(["Sara", "Ali"]));
</script>

اشتباه رایج: <T> را جا می‌اندازی. اگر فقط بنویسی function last(list: T[]): T، تایپ‌اسکریپت می‌پرسد «T دیگر چیست؟» و خط قرمز می‌دهد، چون برچسب را معرفی نکرده‌ای. اول باید بعد از اسم تابع بنویسی <T>، بعد از آن استفاده کنی. راستی، T فقط یک اسم است (حرف اول Type). می‌شد اسمش را Item هم گذاشت، ولی همه به T عادت دارند.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function last(list: T[]): T {
  return list[list.length - 1];
}

show(last([1, 2, 3]));
</script>

مثال‌های این جلسه

چالش‌ها

  1. The Missing Label (آسان)
  2. One Instead of Two (آسان)
  3. Twice (متوسط)
  4. First, or Else (متوسط)
  5. Find the Red Lines (سخت)
  6. The Longer List (سخت)

بیشتر بخوان

← جلسه‌ی 25: پروژه: قهرمان‌ها و هیولاها جلسه‌ی 27: با شرط →