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

اضافه و کم

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

پیشوندهای re- و pre-

re- یعنی «دوباره» یا «به عقب»: reset (دوباره تنظیم کردن)، reload (دوباره بار کردن)، rename (اسم تازه دادن). pre- یعنی «پیش از»: prepend (به اول اضافه کردن)، preview (پیش‌نمایش). با شناختن این دو پیشوند معنی ده‌ها کلمه‌ی تازه را حدس می‌زنی، مثل retry و prefix.

هشت کلمه‌ی این درس

remove (ریموو): برداشتن، حذف کردن از یک مجموعه

remove یعنی «برداشتن» چیزی از جایی که هست. تابعی با این اسم یک عضو را از فهرست، صفحه یا مجموعه بیرون می‌آورد: removeItem()، remove_user(). معمولاً remove یعنی «از این‌جا برش دار» و delete یعنی «کلاً نابودش کن»، هرچند خیلی وقت‌ها جای هم به کار می‌روند.

This method removes the first matching item from the list.

این متد اولین آیتمی را که جور باشد از فهرست برمی‌دارد.

insert (اینسِرت): وسط چیزی جا دادن، درج کردن

insert یعنی چیزی را «وارد کردن» یا «لای چیز دیگری گذاشتن»، مثل گذاشتن کارت در دستگاه. در کد، insert یک عضو را در جای مشخصی از فهرست می‌گذارد و بقیه را یک خانه عقب می‌برد. پس تابعی به اسم insert معمولاً هم خودِ چیز را می‌خواهد و هم جایش را.

Use this command to insert a new row into the table.

با این دستور یک ردیف تازه در جدول درج کن.

append (اَپِند): به آخر چیزی اضافه کردن

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

Each new message is appended to the end of the log file.

هر پیام تازه به آخر فایل لاگ اضافه می‌شود.

prepend (پری‌پِند): به اول چیزی اضافه کردن

prepend برعکس append است: چیزی را «به سر» چیز دیگری اضافه می‌کند. برنامه‌نویس‌ها این کلمه را از روی append ساخته‌اند و pre- را که یعنی «پیش» به اولش گذاشته‌اند. تابعی با این اسم عضو تازه را خانه‌ی اول می‌نشاند و بقیه را عقب می‌برد.

The script prepends the date to every file name.

اسکریپت تاریخ را به اول اسم هر فایل اضافه می‌کند.

pop (پاپ): آخری را برداشتن و تحویل دادن

pop صدای «پَق» است، مثل ترکیدن ذرت در popcorn یا بیرون پریدن چوب‌پنبه. در کد، pop عضو آخر را از فهرست بیرون می‌پراند و همان را به تو می‌دهد. پس دو کار با هم می‌کند: برمی‌دارد و برمی‌گرداند. این با remove فرق دارد که فقط برمی‌دارد.

Calling pop on an empty list raises an error.

صدا زدن pop روی فهرست خالی خطا می‌دهد.

clear (کلی‌یِر): خالی کردن، پاک کردن همه

clear به‌عنوان صفت یعنی «صاف و روشن»، مثل آسمان بی‌ابر، و به‌عنوان فعل یعنی «خالی و تمیز کردن»، مثل جمع کردن میز. تابعی به اسم clear همه‌ی محتوا را بیرون می‌ریزد ولی خودِ ظرف را نگه می‌دارد: فهرست هست، فقط خالی شده. clearScreen() صفحه را پاک می‌کند و clear_cart() سبد خرید را.

Press this button to clear the search field.

برای خالی کردن کادر جست‌وجو این دکمه را بزن.

reset (ری‌سِت): به حالت اول برگرداندن

reset از re- (دوباره) و set (تنظیم کردن) ساخته شده: «دوباره تنظیم کردن». تابعی با این اسم همه چیز را به حالت شروع برمی‌گرداند: resetGame() امتیاز را صفر می‌کند و بازیکن را سر جای اولش می‌گذارد. فرقش با clear این است که clear خالی می‌کند، ولی reset مقدارهای اولیه را برمی‌گرداند.

Click here to reset your password.

برای عوض کردن رمز عبورت این‌جا کلیک کن.

toggle (تاگِل): بین دو حالت جابه‌جا کردن

toggle کلیدی است که فقط دو حالت دارد، مثل کلید برق: هر بار بزنی، اگر روشن بود خاموش می‌شود و اگر خاموش بود روشن. تابعی مثل toggleMenu() همین کار را می‌کند: منو باز است؟ می‌بندد. بسته است؟ باز می‌کند. پس به آن نمی‌گویی کدام حالت؛ خودش برعکس می‌کند.

Press F11 to toggle full screen mode.

برای رفتن به حالت تمام‌صفحه یا بیرون آمدن از آن، F11 را بزن.

مستندات یک کلاس فهرست پخش

Playlist methods

append(song): adds the song to the end of the playlist.
prepend(song): adds the song to the start, so it plays first.
insert(index, song): puts the song at the given position.
remove(song): removes the song from the playlist. The file is not deleted.
pop(): removes the last song and returns it.
clear(): removes all songs. The playlist is empty after this call.
toggleShuffle(): turns shuffle on if it is off, and off if it is on.

متدهای فهرست پخش

append(song): آهنگ را به آخر فهرست پخش اضافه می‌کند.
prepend(song): آهنگ را به اول اضافه می‌کند تا اول از همه پخش شود.
insert(index, song): آهنگ را در جای گفته‌شده می‌گذارد.
remove(song): آهنگ را از فهرست پخش برمی‌دارد. فایل پاک نمی‌شود.
pop(): آخرین آهنگ را برمی‌دارد و آن را برمی‌گرداند.
clear(): همه‌ی آهنگ‌ها را برمی‌دارد. بعد از این فراخوانی فهرست پخش خالی است.
toggleShuffle(): اگر پخش درهم خاموش باشد روشنش می‌کند و اگر روشن باشد خاموش.