readable یعنی چه؟
تلفظ: ریدِبِل · نوع: صفت
معنی readable: خوانا، راحت برای خواندن
read یعنی خواندن و پسوند -able یعنی «شدنی»؛ پس readable یعنی چیزی که راحت خوانده میشود. کد readable کدی است که اسمهایش معنی دارند، خطهایش کوتاهاند و بدون کامنت زیاد هم فهمیده میشود. در بازبینی کد زیاد میشنوی: «این را readableتر کن». اسمش readability است.
readable در جمله
Good names make the code more readable than long comments do.
اسمهای خوب بیشتر از کامنتهای بلند کد را خوانا میکنند.
readable در کد
# Hard to read
if u.a >= 18 and u.c == "IR": ...
# Readable
if user.age >= 18 and user.country == "IR": ...هر دو یک کار میکنند؛ دومی را بدون پرسیدن از کسی میفهمی.
نکته
همین پسوند در editable (قابل ویرایش)، clickable (قابل کلیک) و executable هم هست.
کلمههای مرتبط
- clean code: کد تمیز و خوانا
- simple: ساده
- consistent: یکدست، هماهنگ با بقیه
درس این کلمه
readable یکی از هشت کلمهی درس «کامنت» در فاز 9: نوشتن از دورهی انگلیسی برای برنامهنویسها است. بقیهی کلمههای این درس:
- code comment: توضیحی که برای آدمها کنار کد مینویسی
- TODO: کاری که هنوز باید انجام شود
- FIXME: نشانهی کدی که خراب است و باید درست شود
- docstring: متن راهنمای یک تابع، درون خود کد
- description: توضیح، شرح
- summary: خلاصه
- explanation: توضیحِ دلیل یا روش کار