3. díl - Hrací kostka v C# - Konstruktory a náhodná čísla

C# .NET Objektově orientované programování Hrací kostka v C# - Konstruktory a náhodná čísla American English version English version

V minulém tutoriálu z našeho seriálu o jazyce C# jsme si naprogramovali první objektovou aplikaci. Již umíme tvořit nové třídy a vkládat do nich atributy a metody s parametry a návratovou hodnotou. Dnes začneme pracovat na slíbené aréně, ve které budou proti sobě bojovat dva bojovníci. Boj bude tahový (napřeskáčku) a bojovník vždy druhému ubere život na základě síly jeho útoku a obrany druhého bojovníka. Simulujeme v podstatě stolní hru, budeme tedy simulovat i hrací kostku, která dodá hře prvek náhodnosti. Začněme zvolna a vytvořme si dnes právě tuto hrací kostku. Zároveň se naučíme jak definovat vlastní konstruktor.

Vytvořme si novou konzolovou aplikaci a pojmenujme ji Arena. K projektu si přidejme novou class s názvem Kostka. Zamysleme se nad atributy, které kostce dáme. Jistě by se hodilo, kdybychom si mohli zvolit počet stěn kostky (klasicky 6 nebo 10 stěn, jak je zvykem u tohoto typu her). Dále bude kostka potřebovat tzv. generátor náhodných čísel. Ten nám samozřejmě poskytne .NET framework, který k těmto účelům obsahuje třídu Random. Naše třída bude mít nyní 2 atributy:

  • pocetSten typu int
  • random typu Random, kde bude náhodný generátor.

Minule jsme kvůli jednoduchosti nastavovali všechny atributy naší třídy jako public, tedy jako veřejně přístupné. Většinou se však spíše nechce, aby se daly zvenčí modifikovat a používá se modifikátor private. Atribut je poté viditelný jen uvnitř třídy a zvenčí se C# tváří, že vůbec neexistuje. Při návrhu třídy tedy nastavíme vše na private a v případě, že něco bude opravdu potřeba vystavit, použijeme public. Naše třída nyní vypadá asi takto:

/// <summary>
/// Třída reprezentuje hrací kostku
/// </summary>
class Kostka
{
        /// <summary>
        /// Generátor náhodných čísel
        /// </summary>
        private Random random;
        /// <summary>
        /// Počet stěn kostky
        /// </summary>
        private int pocetSten;

}

Konstruktory

Až doposud jsme neuměli zvenčí nastavit jiné atributy než public, protože např. private nejsou zvenčí viditelné. Již jsme si říkali něco málo o konstruktoru objektu. Je to metoda, která se zavolá ve chvíli vytvoření instance objektu. Slouží samozřejmě k nastavení vnitřního stavu objektu a k provedení případné inicializace. Kostku bychom nyní v Program.cs vytvořili takto:

Kostka kostka = new Kostka();

Právě Kostka() je konstruktor. Protože v naší třídě žádný není, C# si dogeneruje prázdnou metodu. My si však nyní konstruktor do třídy přidáme. Deklaruje se jako metoda, ale nemá návratový typ a musí mít stejné jméno jako je jméno třídy, v našem případě tedy Kostka. V konstruktoru nastavíme počet stěn na pevnou hodnotu a vytvoříme instanci třídy Random. Konstruktor bude vypadat následovně:

public Kostka()
{
        pocetSten = 6;
        random = new Random();
}

Pokud kostku nyní vytvoříme, bude mít v atributu pocetSten 6 a v random bude vytvořená instance generátoru náhodných čísel. Vypišme si počet stěn do konzole, ať vidíme, že tam hodnota opravdu je. Není dobré atribut nastavit na public, protože nebudeme chtít, aby nám někdo mohl již u vytvořené kostky měnit počet stěn. Přidáme do třídy tedy metodu VratPocetSten(), která nám vrátí hodnotu atributu pocetSten. Docílili jsme tím v podstatě toho, že je atribut read-only (atribut není viditelný a lze ho pouze číst metodou, změnit ho nelze). C# má k tomuto účelu ještě další konstrukce, ale tím se zatím nebudeme zabývat. Nová metoda bude vypadat asi takto:

/// <summary>
/// Vrátí počet stěn hrací kostky
/// </summary>
/// <returns>počet stěn hrací kostky</returns>
public int VratPocetSten()
{
        return pocetSten;
}

Přesuňme se do Program.cs a vyzkoušejme si vytvořit kostku a vypsat počet stěn:

Kostka kostka = new Kostka(); // v tuto chvíli se zavolá konstruktor
Console.WriteLine(kostka.VratPocetSten());
Console.ReadKey();

Výstup:

6

Vidíme, že se konstruktor opravdu zavolal. My bychom ale chtěli, abychom mohli u každé kostky při vytvoření specifikovat, kolik stěn budeme potřebovat. Dáme tedy kostruktoru parametr:

public Kostka(int aPocetSten)
{
        pocetSten = aPocetSten;
        random = new Random();
}

Všimněte si, že jsme před název parametru metody přidali znak "a", protože jinak by měl stejný název jako atribut a C# by to zmátlo. Vraťme se k Program.cs a zadejme tento parametr do konstruktoru:

Kostka kostka = new Kostka(10); // v tuto chvíli se zavolá konstruktor s par. 10
Console.WriteLine(kostka.VratPocetSten());
Console.ReadKey();

Výstup:

10

Vše funguje, jak jsme očekávali. C# nám již v tuto chvíli nevygeneruje prázdný (tzv. bezparametrický konstruktor), takže kostku bez parametru vytvořit nelze. My to však můžeme umožnit, vytvořme si další konstruktor a tentokrát bez parametru. V něm nastavíme počet stěn na 6, protože takovou hodnotu asi uživatel naší třídy u kostky očekává jako výchozí:

public Kostka()
{
        pocetSten = 6;
        random = new Random();
}

Zkusme si nyní vytvořit 2 instance kostky, každou jiným konstruktorem (v Program.cs):

Kostka sestistenna = new Kostka();
Kostka desetistenna = new Kostka(10);
Console.WriteLine(sestistenna.VratPocetSten());
Console.WriteLine(desetistenna.VratPocetSten());
Console.ReadKey();

Výstup:

6
10

C# nevadí, že máme 2 metody se stejným názvem, protože jejich parametry jsou různé. Hovoříme o tom, že metoda Kostka (tedy zde konstruktor) má přetížení (overload). Toho můžeme využívat i u všech dalších metod, nejen u konstruktorů. Visual Studio nám přetížení u metod přehledně nabízí (ve chvíli, kdy za název metody napíšeme levou závorku), variantami metody si můžeme listovat pomocí šipek. Tohoto pomocníka nazval MS IntelliSense. V nabídce vidíme naše 2 konstruktory:

Nápověda IntelliSense k přetíženým metodám v C#

Mnoho metod v .NETu má hned několik přetížení, zkuste se podívat např. na metodu Remove() na stringu. Je dobré si u metod projít jejich přetížení, abyste neprogramovali něco, co již někdo udělal před vámi. Například metoda WriteLine(), kterou znáte pro vypisování do konzole, má hned 18 variant

Ukážeme si ještě, jak jde obejít nepraktický název atributu u parametrického konstruktoru (v našem případě aPocetSten) a potom konstruktory na chvíli opustíme. Problém je samozřejmě v tom, že když napíšeme:

public Kostka(int pocetSten)
{
        pocetSten = pocetSten;
        random = new Random();
}

C# neví, kterou z proměnných myslíme, jestli parametr nebo atribut. V tomto případě přiřazujeme do parametru znovu ten samý parametr. VS nás na tuto skutečnost dokonce upozorní. Uvnitř třídy se máme možnost odkazovat na její instanci, je uložena v proměnné this. Využití si můžeme představit např. kdyby kostka měla metodu DejHraci(Hrac hrac) a tam by volala hrac.SeberKos­tku(this). Zde bychom hráči pomocí this předali sebe sama, tedy tu konkrétní kostku, se kterou pracujeme. My se tím zde nebudeme zatěžovat, ale využijeme odkazu na instanci při nastavování atributu:

public Kostka(int pocetSten)
{
        this.pocetSten = pocetSten;
        random = new Random();
}

Pomocí this jsme specifikovali, že levá proměnná pocetSten náleží instanci, pravou C# chápe jako z parametru. Máme tedy 2 konstruktory, které nám umožňují tvořit různé hrací kostky. Přejděme dál.

Náhodná čísla

Definujme na kostce metodu hod(), která nám vrátí náhodné číslo od 1 do počtu stěn. Je to velmi jednoduché, metoda bude public (půjde volat zvenčí) a nebude mít žádný parametr. Návratová hodnota bude typu int. Náhodné číslo získáme tak, že na generátoru zavoláme metodu Next(). Ta má několik přetížení:

  • Next(): Varianta bez parametru vrací náhodné číslo v celém rozsahu datového typu int;
  • Next(Do): Vrací nezáporná čísla menší než mez Do. random.Next(100) tedy vrátí číslo od 0 do 99.
  • Next(Od, Do): Vrátí náhodné číslo v zadané mezi, přičemž Od do intervalu patří a Do již ne. Tedy náhodné číslo od 1 do 100 by bylo random.Next(1, 101);

Pro naše účely se nejlépe hodí třetí přetížení, píšeme tedy:

/// <summary>
/// Vykoná hod kostkou
/// </summary>
/// <returns>Číslo od 1 do počtu stěn</returns>
public int hod()
{
        return random.Next(1, pocetSten + 1);
}

Dejte si pozor, abyste netvořili generátor náhodných čísel v metodě, která má náhodné číslo vracet, tedy že by se pro každé náhodné číslo vytvořil nový generátor. Výsledná čísla pak nejsou téměř náhodná nebo dokonce vůbec. Vždy si vytvořte jednu sdílenou instanci generátoru (např. do privátního atributu pomocí konstruktoru) a na té potom metodu Next() volejte.

Překrývání metody ToString()

Kostka je téměř hotová, ukažme si ještě jednu užitečnou metodu, kterou ji přidáme a kterou budeme hojně používat i ve většině našich dalších objektů. Řeč je o metodě ToString(), o které jsme se již zmínili a kterou obsahuje každý objekt, tedy i nyní naše kostka. Metoda je určena k tomu, aby vrátila tzv. textovou reprezentaci instance. Hodí se ve všech případech, kdy si instanci potřebujeme vypsat nebo s ní pracovat jako s textem. Tuto metodu mají např. i čísla. Již víme, že v C# funguje implicitní konverze, jakmile tedy budeme chtít do konzole vypsat číslo nebo kterýkoli jiný objekt, C# na něm zavolá metodu ToString() a vypíše její výstup. Pokud si děláme vlastní třídu, měli bychom zvážit, zda se nám takováto metoda nehodí. Nikdy bychom si neměli dělat vlastní metodu, např. něco jako Vypis(), když máme v C# připravenou cestu, jak toto řešit. U kostky nemá ToString() vyšší smysl, ale u bojovníka bude jistě vracet jeho jméno. My si ji ke kostce stejně přidáme, bude vypisovat, že se jedná o kostku a vrátí i počet stěn. Nejprve si zkusme vypsat do konzole naši instanci kostky:

Console.WriteLine(sestistenna);

Do konzole se vypíše pouze cesta k naší třídě, tedy Arena.Kostka. Metodu nemůžeme jen tak definovat, protože je již definována (v dalších dílech zjistíme proč). Musíme ji tedy přepsat, resp. překrýt. Tím se opět nebudeme nyní podrobně zabývat, nicméně chci, abychom již teď uměli ToString() používat. K překrytí použijeme klíčové slovo override:

/// <summary>
/// Vrací textovou reprezentaci kostky
/// </summary>
/// <returns>Textová reprezentace kostky</returns>
public override string ToString()
{
        return String.Format("Kostka s {0} stěnami", pocetSten);
}

Nyní opět zkusíme do konzole vypsat přímo instanci kostky.

Výstup:

Kostka s 6 stěnami

Ještě si naše kostky vyzkoušíme. Zkusíme si v programu s našima dvěma kostkama v cyklech házet a podíváme se, jestli fungují tak, jak se očekává:

// vytvoření
Kostka sestistenna = new Kostka();
Kostka desetistenna = new Kostka(10);

// hod šestistěnnou
Console.WriteLine(sestistenna);
for (int i = 0; i < 10; i++)
        Console.Write(sestistenna.hod() + " ");

// hod desetistěnnou
Console.WriteLine("\n\n" + desetistenna);
for (int i = 0; i < 10; i++)
        Console.Write(desetistenna.hod() + " ");

Console.ReadKey();

Výstup může vypadat nějak takto:

Objektová hrací kostka v C#

Máme hotovou docela pěknou a nastavitelnou třídu, která reprezentuje hrací kostku. Bude se nám hodit v naší aréně, ale můžete ji použít i kdekoli jinde. Vidíme, jak OOP umožňuje znovupoužívat komponenty. Příště si řekneme něco o odlišnostech mezi referenčními datovými typy (objekty) a hodnotovými (např. int). :)


 

Stáhnout

Staženo 2095x (27.51 kB)
Aplikace je včetně zdrojových kódů v jazyce C#

 

  Aktivity (6)

Článek pro vás napsal David Čápka
Avatar
Autor pracuje jako softwarový architekt a pedagog na projektu ITnetwork.cz (a jeho zahraničních verzích). Velmi si váží svobody podnikání v naší zemi a věří, že když se člověk neštítí práce, tak dokáže úplně cokoli.
Unicorn College Autor se informační technologie naučil na Unicorn College - prestižní soukromé vysoké škole IT a ekonomie.

Jak se ti líbí článek?
Celkem (34 hlasů) :
4.882364.882364.882364.882364.88236


 



 

 

Komentáře
Zobrazit starší komentáře (73)

Avatar
Jan Vargovský
Redaktor
Avatar
Jan Vargovský:

Je to prostě proměnná třídy, která je využívána skrz tu celou instanci. Je zbytečné jí vytvářet pro každé další číslo té sekvence znova. Navíc by ti nastala ta situace, že když to generuješ často po sobě, tak chytneš ten samý seed a vezmeš si z toho jen první prvek a pak takle dokola, dokud se nezmění ten seed toho randomu (v této implementaci jen dokud se nezmění čas).

 
Odpovědět 14. února 15:51
Avatar
Petr Čech (czubehead):

Tak si to zkus. Dostaneš NullReference­Exception. Jde o to, že Random není to samé jako random. Random je třída kdežto random je proměnná. Když ji neinicializuješ, tj "random = new Random();" bude mít výchozí hodnotu null. Pokud ti to není jasné ani teď, projdi si prostě další návody, časem ti to dojde ;-)

Odpovědět 14. února 16:21
Why so serious? -Joker
Avatar
Petr Čech (czubehead):

Protože tam je Thread.Sleep(); s tím jsem samozřejmě nepočítal. Když to dáš pryč, vyjdou stejná čísla.

Odpovědět 14. února 16:22
Why so serious? -Joker
Avatar
Honza.G
Člen
Avatar
Honza.G:

Zdravím, chci se zeptat, mohl by mi někdo popsat tento kus kodu podrobně prosím?

public override string ToString()
{
        return String.Format("Kostka s {0} stěnami", pocetSten);
}

Předem dík :)

 
Odpovědět 17. května 11:49
Avatar
Xan95
Člen
Avatar
Odpovídá na Honza.G
Xan95:

Čemu přesně nerozumíš? Myslím že je to tu popsáno dost podrobně.

Každý objekt má metodu ToString(), která vrací textovou reprezentaci. Když napíšeš

Kostka kostka = new Kostka();
Console.WriteLine(kostka);

Výstup bude: NazevProjektu­.Kostka

Console.WriteLine(kostka);

se automaticky převede na

Console.WriteLine(kostka.ToString());

Většinou chceš, aby se vypsalo něco přirozenějšího.

public override string ToString()
{
        return String.Format("Kostka s {0} stěnami", pocetSten);
}

Tento kód znamená, že přepíšeš (klíčové slovo override) onu výchozí metodu svou vlastní. V metodě vrátíš string (text, který chceš aby se zobrazil).

return String.Format("Kostka s {0} stěnami", pocetSten);

je to samé jako

return "Kostka s " + pocetSten + " stěnami";

je to samé jako

return "Kostka s " + pocetSten.ToString() + " stěnami";

Nicméně String.Format (= string.Format) je přehlednější. Hlavně, pokud vypisuješ více hodnot.

 
Odpovědět 17. května 13:17
Avatar
Odpovídá na Honza.G
Michal Štěpánek:

A v poslední verzi C# můžeš napsat

public override string ToString()
{
        return String.Format($"Kostka s {pocetSten} stěnami");
}

a vypíše to to samé...

Odpovědět  +1 17. května 13:42
Nikdy neříkej nahlas, že to nejde. Vždycky se totiž najde blbec, který to neví a udělá to...
Avatar
Robert
Člen
Avatar
Robert:

Aký rozdiel je medzi metódou ToString() a Console.Write­Line("Kocka s {0} stenami.", sesthran.Vrat­PocetStien()); ? Efekt je rovnaký

 
Odpovědět 3. listopadu 13:31
Avatar
Robert
Člen
Avatar
Robert:

Takže pomôže len dať tam sleep?

 
Odpovědět 3. listopadu 14:08
Avatar
Odpovídá na Robert
Michal Štěpánek:

Napsal jsi ten dotaz trochu nešťastně. Metoda "ToString()" vrací textovou reprezentaci objektu, kdežto

Console.WriteLine("Kocka s {0} stenami.", sesthran.VratPocetStien())

vypíše, kolik má daná kostka stěn...

Odpovědět 3. listopadu 17:51
Nikdy neříkej nahlas, že to nejde. Vždycky se totiž najde blbec, který to neví a udělá to...
Děláme co je v našich silách, aby byly zdejší diskuze co nejkvalitnější. Proto do nich také mohou přispívat pouze registrovaní členové. Pro zapojení do diskuze se přihlas. Pokud ještě nemáš účet, zaregistruj se, je to zdarma.

Zobrazeno 10 zpráv z 83. Zobrazit vše