বাধ্য হও!!

TL;DR: অস্পষ্ট নামের ফাংশন উদ্দেশ্য লুকিয়ে রাখে এবং পাঠকদের বিভ্রান্ত করে। বর্ণনামূলক, কর্ম-ভিত্তিক নাম ব্যবহার করুন।

সমস্যা

• অস্পষ্ট ফাংশন উদ্দেশ্য
• জ্ঞানীয় লোড বৃদ্ধি
• বিভ্রান্তিকর প্রসঙ্গ
• পঠনযোগ্যতা হ্রাস
• কঠিন সহযোগিতা
• লুকানো কার্যকারিতা

সমাধান

1. কর্ম-ভিত্তিক ক্রিয়া ব্যবহার করুন
2. নাম বর্ণনামূলক করুন
3. ফাংশনের উদ্দেশ্য প্রতিফলিত করুন
4. জেনেরিক পদ এড়িয়ে চলুন
5. অর্থপূর্ণ প্রসঙ্গ প্রদান করুন
6. একক দায়িত্ব স্পষ্টভাবে প্রকাশ করুন
7. ফলাফলের সাথে অ্যাকশন ম্যাচ করুন

রিফ্যাক্টরিং

https://hackernoon.com/improving-the-code-one-line-at-a-time

প্রসঙ্গ

জেনেরিক পদের সাথে নামযুক্ত ফাংশন পাঠকদের তাদের আচরণ বোঝার জন্য বাস্তবায়নে ডুব দিতে বাধ্য করে।

এটি সময় নষ্ট করে এবং ত্রুটির সম্ভাবনা বাড়ায়।

স্বতন্ত্র ফাংশনগুলির সাথে কাজ করার সময় নামকরণ আরও বেশি গুরুত্বপূর্ণ হয়ে ওঠে, যেখানে ক্লাসের নাম অতিরিক্ত প্রসঙ্গ প্রদান করে না।

এই সমস্যাটি সরাসরি বলুন, জিজ্ঞাসা করবেন না নীতির সাথে সম্পর্কিত।

অস্পষ্ট আচরণগুলি প্রকাশ করার পরিবর্তে যা কলকারীকে কার্যকারিতা অনুমান করতে বাধ্য করে, বাধ্যতামূলক নামগুলি সঠিক ক্রিয়া প্রকাশ করে, কোডটি পরিদর্শন করার প্রয়োজন ছাড়াই পাঠককে গাইড করে।

আপনি যখন বর্ণনামূলকভাবে ফাংশনগুলির নাম দেন, তখন আপনি অপ্রয়োজনীয় অনুমানগুলি দূর করেন এবং এই নীতির সাথে সারিবদ্ধ হন।

নমুনা কোড

ভুল

 public String dateFormatting(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void load() { System.out.println("Loading..."); }

ঠিক

 public String formatDate(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void loadUserPreferences() { System.out.println("Loading user preferences..."); }

সনাক্তকরণ

• [x] ম্যানুয়াল

ডু , রান , প্রসেস , লোড ইত্যাদির মতো অস্পষ্ট পদ ব্যবহার করে এমন ফাংশন নাম পর্যালোচনা করে আপনি এই গন্ধ সনাক্ত করতে পারেন।

স্বয়ংক্রিয় লিন্টারগুলি এই নিদর্শনগুলিকে পতাকাঙ্কিত করতে পারে বা অতিমাত্রায় জেনেরিক নাম দিয়ে ফাংশনগুলিকে হাইলাইট করতে পারে৷

ট্যাগ

• নামকরণ

স্তর

• [x] শিক্ষানবিস

কেন বিজেকশন গুরুত্বপূর্ণ

ফাংশনের নামগুলি তাদের নাম এবং কার্যকারিতার মধ্যে একটি স্পষ্ট এক-থেকে-এক চিঠিপত্র তৈরি করা উচিত।

এই Bijection ভঙ্গ করা ডেভেলপারদের প্রসঙ্গ, ডিবাগিং, পর্যালোচনা এবং এক্সটেনশনের জন্য কোডের বিবরণ পরীক্ষা করতে বাধ্য করে।

এআই জেনারেশন

এআই টুল কখনও কখনও আপনার ডোমেন না বুঝে জেনেরিক ফাংশন নাম তৈরি করে।

AI ব্যবহার করার সময়, নির্দিষ্ট করুন যে ফাংশনের নাম অবশ্যই বর্ণনামূলক এবং অ্যাকশন-ভিত্তিক হতে হবে।

এআই সনাক্তকরণ

এআই মডেলগুলি পূর্বনির্ধারিত নামকরণের সর্বোত্তম অনুশীলনের সাথে ফাংশন স্বাক্ষরের তুলনা করে অস্পষ্ট নাম সনাক্ত করতে সহায়তা করতে পারে।

ম্যানুয়াল কোড পর্যালোচনার সাথে AI-এর সমন্বয় সর্বোত্তম ফলাফল দেয়।

তাদের চেষ্টা করুন!

মনে রাখবেন: এআই সহকারীরা অনেক ভুল করে

উপসংহার

ফাংশনের নাম শুধু লেবেল নয়; তারা পাঠকের সাথে চুক্তি।

অস্পষ্ট নাম এই চুক্তি ভঙ্গ করে এবং বিভ্রান্তির দিকে পরিচালিত করে।

বর্ণনামূলক, অ্যাকশন-ভিত্তিক নাম যোগাযোগ সহজ করে এবং আপনার কোড বজায় রাখা এবং প্রসারিত করা সহজ করে।

সম্পর্ক

এছাড়াও দেখুন

দাবিত্যাগ

কোড গন্ধ আমার মতামত .

ক্রেডিট

আনস্প্ল্যাশে ব্রিটিশলাইব্রেরির ছবি

একটি ফাংশন নাম একটি ক্রিয়া বা একটি ক্রিয়া বাক্যাংশ হওয়া উচিত, এবং এটি অর্থপূর্ণ হতে হবে

রবার্ট সি মার্টিন

এই নিবন্ধটি CodeSmell সিরিজের অংশ।