Hello World في C#: الدالة Main وConsole.WriteLine وReadLine

أول برنامج تقليدي يطبع سطرًا واحدًا من النص. في C# يبدو هكذا:

using System;

class Program
{
    static void Main()
    {
        Console.WriteLine("Hello, World!");
    }
}

المخرجات:

Hello, World!

سطرًا سطرًا

• يتيح لك using System; كتابة Console بدل الاسم الكامل System.Console. وConsole صنف في فضاء الأسماء System (راجع فضاءات الأسماء وusing).
• يصرّح class Program بصنف. كل شيفرة C# تعيش داخل نوع؛ والاسم Program عُرف متّبع وليس شرطًا.
• static void Main() هي نقطة الدخول. عند بدء البرنامج يبحث وقت التشغيل عن دالة ساكنة اسمها Main ويستدعيها. تعني static أنها تنتمي إلى الصنف نفسه، فلا حاجة لإنشاء كائن أولًا. وتعني void أنها لا تعيد شيئًا.
• يستدعي Console.WriteLine("Hello, World!"); الدالة WriteLine بوسيط نصي. تنتهي كل عبارة بفاصلة منقوطة.
• تحدّد الأقواس المعقوصة { } جسم الصنف وجسم الدالة.

C# حساسة لحالة الأحرف. console.writeline وmain اسمان مختلفان عن Console.WriteLine وMain، ولا وجود لأي منهما.

Console.WriteLine مقابل Console.Write

تضيف WriteLine سطرًا جديدًا بعد النص. أما Write فلا، فيكمل الإخراج التالي في السطر نفسه. كلتاهما تقبل أي نوع لا النصوص فقط: تُحوَّل الأرقام والقيم المنطقية والكائنات بدالتها ToString().

using System;

class Program
{
    static void Main()
    {
        Console.Write("Loading");
        Console.Write(".");
        Console.Write(".");
        Console.WriteLine(" done");

        Console.WriteLine(42);
        Console.WriteLine(true);
        Console.WriteLine();              // an empty line

        string item = "coffee";
        decimal price = 3.20m;
        Console.WriteLine("Item: " + item);             // concatenation
        Console.WriteLine($"{item} costs {price:F2}");   // interpolation
        Console.WriteLine("{0} costs {1:F2}", item, price); // composite format
    }
}

المخرجات:

Loading.. done
42
True

Item: coffee
coffee costs 3.20
coffee costs 3.20

لاحظ أن true تُطبع True: هذا ما تعيده bool.ToString(). الصيغة $"..."، واسمها استيفاء النصوص، هي التي ستستخدمها أكثر من غيرها؛ راجع استيفاء النصوص لرموز التنسيق مثل :F2.

قراءة المدخلات بـ Console.ReadLine

تنتظر Console.ReadLine() أن يكتب المستخدم سطرًا ويضغط Enter، ثم تعيد ذلك السطر كـ string دون محرف السطر الجديد. وعند نهاية المدخلات (مثلًا حين تُعاد توجيه المدخلات من ملف انتهى) تعيد null.

// stdin: Maya\n27
using System;

class Program
{
    static void Main()
    {
        Console.Write("What is your name? ");
        string name = Console.ReadLine();

        Console.Write("How old are you? ");
        string ageText = Console.ReadLine();

        int age;
        if (int.TryParse(ageText, out age))
        {
            Console.WriteLine();
            Console.WriteLine($"Hi {name}, next year you will be {age + 1}.");
        }
        else
        {
            Console.WriteLine();
            Console.WriteLine($"'{ageText}' is not a number.");
        }
    }
}

المخرجات:

What is your name? How old are you? 
Hi Maya, next year you will be 28.

حين تشغّل هذا في طرفية يظهر النص الذي تكتبه بعد كل سؤال. لا يحتوي الإخراج أعلاه على نص مكتوب لأن المدخلات أُعيد توجيهها (مُرّرت بأنبوب) بدل كتابتها، فلا يظهر إلا ما يكتبه البرنامج نفسه.

تعيد ReadLine نصًا دائمًا. لاستخدام القيمة كرقم عليك تحويلها. ترمي int.Parse(text) استثناء FormatException حين لا يكون النص رقمًا؛ أما int.TryParse فتعيد false بدلًا من ذلك، ولهذا هي الخيار الصحيح لمدخلات المستخدم. التفاصيل في تحويل الأنواع.

دالتان ذواتا صلة: تعيد Console.Read() المحرف التالي كرمز int، وتقرأ Console.ReadKey() ضغطة مفتاح واحدة دون انتظار Enter (تعمل في الطرفية التفاعلية فقط).

الأشكال الأخرى للدالة Main

يمكن لـ Main أن تأخذ وسائط سطر الأوامر وأن تعيد رمز خروج. كل ما يلي نقاط دخول صالحة:

static void Main()
static void Main(string[] args)
static int Main()
static int Main(string[] args)
static async Task Main()             // C# 7.1 and later
static async Task<int> Main(string[] args)  // C# 7.1 and later

تصبح قيمة int المعادة رمز خروج العملية، الذي تقرؤه السكربتات وأنظمة CI لتقرّر هل نجح البرنامج (0 يعني النجاح عرفًا).

using System;

class Program
{
    static int Main(string[] args)
    {
        Console.WriteLine($"Got {args.Length} argument(s)");
        foreach (string arg in args)
        {
            Console.WriteLine("  " + arg);
        }
        return 0;
    }
}

المخرجات:

Got 0 argument(s)

شغّله بـ dotnet run -- apples pears فتحمل args القيمتين "apples" و"pears". تفصل -- وسائط برنامجك عن وسائط أداة dotnet.

التعليقات

في C# ثلاثة أنواع من التعليقات. يتجاهلها المترجم جميعًا.

// A single-line comment runs to the end of the line.

/* A block comment
   can span several lines. */

/// <summary>
/// An XML documentation comment. Editors show it as the tooltip for the method.
/// </summary>
static decimal ApplyDiscount(decimal price) => price * 0.9m;

استخدم // للملاحظات داخل الشيفرة. تُوضع تعليقات /// على الأنواع والأعضاء العامة؛ تعرضها بيئة التطوير حين تمرّر المؤشر فوق استدعاء، ويستطيع المترجم تصديرها إلى ملف XML لأدوات التوثيق.

إنشاء مشروع وتشغيله بـ dotnet

على جهازك، ثبّت .NET SDK من dotnet.microsoft.com، ثم:

dotnet new console -o HelloApp
cd HelloApp
dotnet run

Hello, World!

ينشئ dotnet new console ملفين: HelloApp.csproj (ملف المشروع: إطار العمل المستهدف والإعدادات ومراجع الحزم) وProgram.cs. يترجم dotnet run المشروع ويشغّله. ويترجم dotnet build دون تشغيل ويكتب الناتج في bin/Debug/net8.0/ (يتبع اسم المجلد إطار العمل المستهدف).

العبارات عالية المستوى (C# 9 وما بعده)

افتح Program.cs المولَّد وستجد هذا، ولا شيء غيره:

// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

هذا برنامج بعبارات عالية المستوى (top-level statements)، وهي ميزة من C# 9. يولّد المترجم الصنف Program والدالة Main حول عباراتك. وusing System; غائبة أيضًا لأن مشاريع .NET 6 وما بعدها تفعّل موجّهات using الضمنية: تُستورد فضاءات الأسماء الشائعة مثل System وSystem.IO وSystem.Linq وSystem.Collections.Generic للمشروع كله.

ما زال بإمكان البرامج عالية المستوى قراءة args واستخدام await وإعادة رمز خروج بـ return:

// C# 9 and later: the whole Program.cs
Console.Write("Name: ");
string? name = Console.ReadLine();
Console.WriteLine($"Hello, {name}! You passed {args.Length} arguments.");
return 0;

لا يمكن إلا لملف واحد في المشروع أن يحتوي على عبارات عالية المستوى، ويجب أن تأتي الأنواع (الأصناف والسجلات) بعدها. الوسم string? نوع مرجع قابل لـ null (C# 8)، وهو موجود لأن ReadLine قد تعيد null. الشكل الصريح class Program المستخدم في أمثلة هذه الصفحة مكافئ، وهو ما ستراه في الشيفرات الأقدم وفي معظم سكربتات Unity، لذا يستحق أن تقدر على قراءة الشكلين. مرّر --use-program-main إلى dotnet new console إن كنت تفضّل الشكل الصريح في المشاريع الجديدة.

أول الأخطاء التي ستراها

• CS1002: ; expected. عبارة تنقصها الفاصلة المنقوطة. يُبلَّغ عن الخطأ في نهاية السطر الذي تنقصه.
• CS0103: The name 'console' does not exist in the current context. حالة أحرف خاطئة، أو غياب using System; في مشروع بلا موجّهات using ضمنية.
• CS5001: Program does not contain a static 'Main' method suitable for an entry point. اسم Main مكتوب خطأ، أو ليست static، أو توقيعها غير مدعوم.
• CS0017: Program has more than one entry point defined. لصنفين كل منهما Main. أبقِ واحدة، أو اختر إحداهما بالإعداد StartupObject في ملف .csproj.
• النافذة تُغلق فورًا. حين يبدأ تطبيق كونسول بنقرة مزدوجة تُغلق النافذة عند عودة Main. شغّله من طرفية، أو أضف Console.ReadKey(); في النهاية أثناء الاختبار.