Túlterhelés, opcionális paraméter, out és ref

1Túlterhelés: egy név, több alak

A D1–D2-ben vonalhúzó metódusokat írtunk — többfélét, több néven. Pedig mind ugyanazt csinálja, csak más bemenettel. C#-ban adhatjuk nekik ugyanazt a nevet:

Vonal();                 // alapvonal
Vonal(50);               // hosszabb
Vonal('=', 20);          // más jelből

void Vonal()
{
    Vonal('-', 30);      // a rövid alak a teljeset hívja — nincs másolás!
}

void Vonal(int hossz)
{
    Vonal('-', hossz);
}

void Vonal(char jel, int hossz)
{
    for (int i = 0; i < hossz; i++)
    {
        Console.Write(jel);
    }
    Console.WriteLine();
}

• Ez a túlterhelés (overload): azonos név, különböző paraméterlista. A fordító a hívás argumentumaiból választja ki, melyik fusson.
• A név + paraméterlista együtt a szignatúra — két metódus akkor fér meg, ha a szignatúrájuk különbözik. A visszatérési típus önmagában nem elég különbségnek (CS0111).
• Figyeld meg a mintát: a rövid alakok a legteljesebbet hívják — a tényleges munka egyetlen helyen van (DRY, D1!).

2Opcionális paraméter: az alapértelmezett érték

A háromalakú vonalhúzó egyetlen metódussal is megoldható:

void Vonal(char jel = '-', int hossz = 30)
{
    for (int i = 0; i < hossz; i++)
    {
        Console.Write(jel);
    }
    Console.WriteLine();
}

Vonal();                 // '-' jelből 30
Vonal('=');              // '=' jelből 30
Vonal('=', 20);          // '=' jelből 20

• Az = '-' a fejlécben alapértelmezett érték: ha a hívás nem ad argumentumot, ez lép életbe.
• Az opcionális paraméterek a lista végén állnak (CS1737) — elöl a kötelezők.
• És ha csak a hosszt adnád meg, a jelet nem? Név szerinti argumentummal lehet: Vonal(hossz: 10); — a paraméter nevével címezve a sorrend is felrúgható. Ritkán kell, de jó tudni róla.

3Az out: a TryParse titka megfejtve

A D2-ben rögzítettük: a metódus másolatot kap, a hívó változójához nem nyúl. Az out ez alól ad szabályozott kivételt: az out paraméteren keresztül a metódus a hívó változójába ír.

Most már megírhatjuk a saját „TryParse-szabású” metódusunkat:

if (BiztonsagosOsztas(10, 3, out int hanyados))
{
    Console.WriteLine($"Az eredmény: {hanyados}");
}
else
{
    Konzol.Hiba("Nullával nem osztunk!");
}

bool BiztonsagosOsztas(int a, int b, out int eredmeny)
{
    if (b == 0)
    {
        eredmeny = 0;        // out-nak MINDEN úton értéket kell kapnia
        return false;
    }
    eredmeny = a / b;
    return true;
}

• A minta ugyanaz, mint a TryParse-é: a visszatérési érték a siker (bool), az out paraméter az eredmény. Két kimenet egy hívásból.
• A metódus köteles minden kódútvonalon értéket adni az out paraméternek (CS0177) — ezért ír a TryParse is 0-t hibás bevitelnél.
• A hívásnál az out kulcsszót ki kell írni (CS1620): jól látszik, hogy az a változó a hívásban íródni fog.

És ezzel a B6-os rejtély teljesen megoldva — olvasd el a fejlécet, ma már minden szava ismerős:

public static bool TryParse(string s, out int result)

4A ref: helyben módosítás

Az out-nál a metódus ad; a ref-nél a metódus a hívó meglévő értékét kapja meg és módosíthatja:

int pontszam = 80;
Bonusz(ref pontszam);
Console.WriteLine(pontszam);     // 90 — tényleg megváltozott!

void Bonusz(ref int ertek)
{
    ertek += 10;
}

• A ref változónak híváskor már legyen értéke (az out-nak nem kell).
• A kulcsszó itt is kötelező a hívásban: Bonusz(ref pontszam);.

5Gyakori hibák

6Gyakorlat — a SzamotKer megtanul határok között kérdezni

1. Nyisd meg az előző órai projektet (benne a D2-es Konzol.SzamotKer-rel).
2. Írd meg a Konzol.cs-be a túlterhelt változatot: public static int SzamotKer(string kerdes, int min, int max) — addig kérdezzen újra, amíg a szám a határok közé nem esik (C5-ös do-while + C1-es feltétel), a hibaüzenet nevezze meg a határokat.
3. A törzsben használd az egyparaméteres alakot: a számot azzal kérd be, és csak a tartományt ellenőrizd — DRY!
4. Írd át a számkitalálót: int tipp = Konzol.SzamotKer("Tipped: ", 1, 100); — és próbáld ki tartományon kívüli számmal.
5. Bónusz: adj a Konzol.Elvalaszto-nak opcionális paramétereket (char jel = '─', int hossz = 28).
6. Commit: SzamotKer tulterheles min-max hatarokkal.

7Feladatok

8Önellenőrző kvíz

9Fogalomtár

10Összegzés