کامنتهای ++C
کامنتهای برنامه، جملات توضیحی هستند که میتوانید در کد C++ خود وارد کنید. این کامنتها به هر کسی که کد منبع را میخواند کمک میکنند. همه زبانهای برنامهنویسی اجازه استفاده از نوعی کامنت را میدهند.
انواع کامنتهای ++C
C++ از دو نوع کامنت پشتیبانی میکند: کامنتهای تکخطی و کامنتهای چندخطی. تمام کاراکترهای موجود در هر کامنتی توسط کامپایلر C++ نادیده گرفته میشوند.
انواع کامنتهای C++
در بخشهای بعدی به تفصیل توضیح داده شدهاند:
- کامنتهای تکخطی C++ یک کامنت تکخطی با // شروع میشود و تا انتهای همان خط ادامه دارد. این کامنتها فقط تا پایان همان خط معتبر هستند و خط بعدی شروع کامنت جدیدی است.
نحو
نحو زیر نشان میدهد چگونه میتوان از کامنت تکخطی در C++ استفاده کرد:
// Text to be commented
مثال
در مثال زیر، ما در حال ایجاد کامنتهای تکخطی هستیم
#include <iostream> using namespace std; int main() { // this is a single line comment cout << "Hello world!" << endl; // for a new line, we have to use new comment sections cout << "This is second line."; return 0; }
خروجی
Hello world! This is second line.
- کامنتهای چندخطی در C++ کامنتهای چندخطی با نماد /* شروع میشوند و با نماد */ پایان مییابند. هر متنی که بین این دو نماد قرار بگیرد فقط بهعنوان کامنت در نظر گرفته میشود.
نحو
نحو زیر نشان میدهد چگونه میتوان از کامنت چندخطی در C++ استفاده کرد:
/* This is a comment */ /* C++ comments can also span multiple lines */
مثال
در مثال زیر، ما در حال ایجاد کامنتهای چندخطی هستیم
#include <iostream> using namespace std; int main() { /* Printing hello world!*/ cout << "Hello World!" << endl; /* This is a multi-line comment Printing another message Using cout */ cout << "Tutorials Point"; return 0; }
خروجی
Hello World! Tutorials Point
کامنتگذاری درون دستورات ما همچنین میتوانیم دستورات خاصی را درون یک بلوک کد در برنامه C++ کامنتگذاری (غیرفعال) کنیم. این کار با استفاده از هر دو نوع کامنت امکانپذیر است.
مثال
مثال زیر نحوه استفاده از کامنتهای چندخطی درون دستورات را توضیح میدهد −
#include <iostream> using namespace std; int main() { cout << "This line" /*what is this*/ << " contains a comment" << endl; return 0; }
خروجی
This line contains a comment
مثال
مثال زیر نحوه استفاده از کامنتهای تکخطی درون دستورات را توضیح میدهد −
#include <iostream> using namespace std; int main() { cout << "This line" // what is this << " contains a comment" << endl; return 0; }
خروجی
This line contains a comment
تو در تو کردن کامنتها
در یک کامنت با نمادهای /* و /، کاراکترهای // هیچ معنای خاصی ندارند. همچنین در یک کامنت که با // شروع میشود، نمادهای / و */ معنای خاصی ندارند. بنابراین، شما میتوانید یک نوع کامنت را درون نوع دیگر “تو در تو” کنید.
مثال
مثال زیر نحوه استفاده از کامنتها درون یکدیگر با استفاده از تکنیک تو در تو کردن را توضیح میدهد −
#include <iostream> using namespace std; int main() { /* Comment out printing of Hello World: cout << "Hello World"; // prints Hello World */ cout << "New, Hello World!"; return 0; }
خروجی
New, Hello World!
کامنتهای تکخطی یا چندخطی
چه زمانی استفاده کنیم؟ کامنتهای تکخطی معمولاً برای نوشتن توضیحات کوتاه به کار میروند. این نوع کامنت بیشتر زمانی استفاده میشود که بخواهیم نکتهای کوچک یا اشارهای مختصر به الگوریتم درون کد داشته باشیم.کامنتهای چندخطی معمولاً برای توضیحات طولانیتر استفاده میشوند، جایی که لازم است کل توضیح بهطور کامل دیده شود. هرچه طول کامنت بیشتر باشد، نیاز به استفاده از کامنت چندخطی بیشتر احساس میشود.
هدف از کامنتگذاری
کامنتها در C++ اهداف مختلفی دارند. برخی از کاربردهای اصلی کامنتها به شرح زیر هستند:
- نمایش یک مرحلهی کوتاه و مختصر در برنامه برای درک بهتر کاربران.
- توضیح یک مرحله به شکل کامل، که در کد بهصورت واضح مشخص نیست.
- ارائهی نکات و راهنماییهای مختلف برای درک بهتر کد.
- گذاشتن کامنتهای سرگرمکننده یا تفننی.
- غیرفعال کردن موقت بخشی از کد برای رفع اشکال (دیباگ).
- افزودن فراداده (metadata) به کد برای استفادههای آتی.
- ایجاد مستندات برای کد، به عنوان مثال در صفحات گیتهاب (GitHub Pages).