C# da Comments

C# da Comments nima ?

Comments (izohlar) — bu dastur kodidagi maxsus qismlar bo'lib, ular dastur ishlashi va natijasiga ta'sir qilmaydi. Ular faqat dasturchi uchun kodni tushuntirish, eslatma qoldirish yoki ma'lum bir qismni vaqtincha o'chirib qo'yish uchun ishlatiladi. Kompilyator (kodni mashina tiliga aylantiruvchi dastur) izohlarni e'tiborsiz qoldiradi.

C# da izohlarning ikki asosiy turi mavjud

  1. Bir qatorli izohlar (Single-line comments)

  2. Ko'p qatorli izohlar (Multi-line comments) Bundan tashqari, maxsus hujjatlashtirish uchun XML hujjat izohlari ham ishlatiladi.

1) Bir qatorli izohlar (Single-line Comments)

Bir qatorli izohlar // belgisi bilan boshlanadi va qator oxirigacha davom etadi. Bu izohlar odatda qisqa tushuntirishlar yoki eslatmalar uchun ishlatiladi.

Misol

using System;

class Program
{
    static void Main(string[] args)
    {
        // Bu bir qatorli izoh
        Console.WriteLine("Salom, dunyo!"); // Bu kod ekranga matn chiqaradi
    }
}

Tushuntirish

  • // Bu bir qatorli izoh — bu qator kompilyator tomonidan e'tiborsiz qoldiriladi.

  • // Bu kod ekranga matn chiqaradi — bu kodning maqsadini tushuntiradi.

  • Natija: Dastur faqat Console.WriteLine("Salom, dunyo!"); ni bajaradi va ekranga Salom, dunyo! chiqaradi.

Foydalanish

  • Kodning ma'lum bir qismini tushuntirish uchun.

  • Kodni vaqtincha o'chirib qo'yish uchun (masalan, test paytida).

Yana bir misol

using System;

class Program
{
    static void Main(string[] args)
    {
        // int x = 10; // Bu qator o'chirildi, chunki test qilish kerak emas
        Console.WriteLine("Dastur ishladi!");
    }
}

Natija

Dastur ishladi!

Bu yerda int x = 10; qatori izoh sifatida o'chirilgan, shuning uchun dastur uni ko'rmaydi.

2) Ko'p qatorli izohlar (Multi-line Comments)

Ko'p qatorli izohlar /* bilan boshlanadi va */ bilan tugaydi. Ular bir nechta qatorlarni izoh sifatida belgilash uchun ishlatiladi.

Misol

using System;

class Program
{
    static void Main(string[] args)
    {
        /* Bu ko'p qatorli izohdir.
           U bir nechta qatorlarni qamrab oladi.
           Bu yerda dasturning maqsadini tushuntirish mumkin. */
        Console.WriteLine("Salom, dunyo!");
    }
}

Tushuntirish

  • /* va */ orasidagi hamma narsa izoh sifatida hisoblanadi.

  • Bu izohlar uzunroq tushuntirishlar yoki bir nechta qator kodni o'chirish uchun ishlatiladi.

  • Natija: Faqat Salom, dunyo! ekranga chiqadi.

Yana bir misol

using System;

class Program
{
    static void Main(string[] args)
    {
        /* 
        int a = 5;
        int b = 10;
        int yigindi = a + b;
        Console.WriteLine(yigindi);
        */
        Console.WriteLine("Bu test dasturi!");
    }
}

Natija

Bu test dasturi!

Bu yerda bir nechta qator kod ko'p qatorli izoh sifatida o'chirilgan.

3) XML hujjat izohlari (XML Documentation Comments)

C# da maxsus izoh turi sifatida XML hujjat izohlari ishlatiladi. Ular /// bilan boshlanadi va odatda metodlar, sinflar yoki o'zgaruvchilarni hujjatlashtirish uchun qo'llaniladi. Bu izohlar dastur dokumentatsiyasini avtomatik yaratishda (masalan, Visual Studio yoki boshqa vositalar yordamida) foydali.

Misol

using System;

class Program
{
    /// <summary>
    /// Bu metod foydalanuvchiga salomlashuv xabarini chiqaradi.
    /// </summary>
    /// <param name="ism">Foydalanuvchining ismi</param>
    static void Salomlash(string ism)
    {
        Console.WriteLine($"Salom, {ism}!");
    }

    static void Main(string[] args)
    {
        Salomlash("Ali");
    }
}

Tushuntirish

  • /// <summary> — metodning umumiy maqsadini tushuntiradi.

  • /// <param name="ism"> — metod parametrlarini tavsiflaydi.

  • Bu izohlar Visual Studio kabi muhitlarda metodlar haqida avtomatik ma'lumot chiqaradi (masalan, metodni ishlatishda tooltip sifatida ko'rinadi).

  • Natija:

    Salom, Ali!

Foydalanish

  • Katta loyihalarda kodni hujjatlashtirish uchun.

  • API yoki kutubxona yozishda foydalanuvchilarga ma'lumot berish uchun.

4) Izohlardan foydalanishning afzalliklari

  • Tushunarli kod: Izohlar kodning maqsadini boshqa dasturchilarga (yoki kelajakda o'zingizga) tushuntiradi.

  • Xatolarni kamaytirish: Kodning ma'lum qismlarini tushuntirib, xato qilish ehtimolini kamaytiradi.

  • Testlashda yordam: Keraksiz kodni vaqtincha izoh sifatida o'chirib, dasturni test qilish mumkin.

  • Hujjatlashtirish: XML izohlar yordamida loyiha uchun professional hujjatlar yaratiladi.

5) Izohlarni yozishda e'tibor berish kerak bo'lganlar

  • Ortiqcha izoh yozmang: Har bir qatorni izohlash shart emas. Faqat murakkab yoki muhim qismlarni tushuntiring.

    // Noto'g'ri:
int x = 5; // x ga 5 qiymati berildi

// To'g'ri:
int x = 5; // Foydalanuvchi ballarini saqlash uchun ishlatiladi

  • Izohlarni yangilab turing: Agar kod o'zgarsa, izohlarni ham yangilang, aks holda ular noto'g'ri ma'lumot berishi mumkin.

  • Tushunarli yozing: Izohlar qisqa, aniq va maqsadga mos bo'lishi kerak.

6) Amaliy misol - Izohlar bilan to'liq dastur

using System;

class Program
{
    // Bu dastur foydalanuvchidan ism va yoshni oladi va salom lashuv chiqaradi
    static void Main(string[] args)
    {
        Console.Write("Ismingizni kiriting: "); // Foydalanuvchidan ism so'raydi
        string ism = Console.ReadLine();

        Console.Write("Yoshingizni kiriting: "); // Foydalanuvchidan yosh so'raydi
        int yosh = Convert.ToInt32(Console.ReadLine());

        /* Quyidagi kod foydalanuvchiga salomlashuv xabarini
           va uning yoshini chiqaradi */
        Console.WriteLine($"Salom, {ism}! Siz {yosh} yoshdasiz.");
    }
}

Natija

Ismingizni kiriting: Ali
Yoshingizni kiriting: 20
Salom, Ali! Siz 20 yoshdasiz.

Tushuntirish

  • Dasturda har bir qadam izoh bilan tushuntirilgan.

  • // bir qatorli izohlar va /* */ ko'p qatorli izohlar ishlatilgan.

  • Izohlar kodni o'qigan odamga dasturning maqsadini va har bir qismini tushunishda yordam beradi.

Yoda tuting !

  • Bir qatorli izohlar (//): Qisqa tushuntirishlar yoki kodni vaqtincha o'chirish uchun.

  • Ko'p qatorli izohlar (/* */): Uzunroq tushuntirishlar yoki bir nechta qator kodni o'chirish uchun.

  • XML hujjat izohlari (///): Kodni hujjatlashtirish va professional loyihalarda ishlatish uchun.

  • Izohlar kodni tushunarli, boshqariladigan va keyinchalik o'zgartirish uchun qulay qiladi.

  • Yaxshi izoh yozish — dasturchilikda muhim odat, lekin ortiqcha izohlardan qochish kerak.

PreviousC# da Output nima ?NextWeb Application Security

Last updated

Was this helpful?