Kierros 9, tehtävä 4

Luokan kirjoittaminen (270 p)

Tässä tehtävässä harjoitellaan erityisesti seuraavia asoita:

• luokan kirjoittaminen
• lista luokan kenttänä. Tätä asiaa käsitellään 21.-23.3. pidettävillä luennoilla.

Tässä tehtävässä sinun ei tarvitse kirjoittaa lainkaan pääohjelmaa, vaan sinun tehtäväsi on kirjoittaa olion ominaisuudet ja toiminnot määrittelevä luokka. Huomaa siis, että sinun kirjoittamasi luokan ei tarvitse tulostaa mitään eikä pyytää mitään käyttäjältä. Kaikki kommunikointi käyttäjän kanssa tapahtuu valmiina annetussa moduulissa.

Luo uusi projekti tehtava9_4 ja siihen moduuli pituushyppaaja. Kirjoita tähän moduliin luokka Pituushyppaaja yhden pituushyppykilpailun osanottajan kuvaamista varten. Kopioi myös samaan projektiin toinen moduuli pituushyppaajia. Se sisältää testiohjelman, jonka avulla voit testata kirjoittamasi luokan toimintaa. Älä muuta moduulin pituushyppaajia sisältöä mitenkään.

Huomaa, että moduulin nimi pitää kirjoittaa pienellä alkukirjaimella. Vastaavasti luokan nimi pitää kirjoittaa isolla alkukirjaimella. Muuten Goblinin tarkistukset eivät toimi.

Määrittele Pituushyppaaja-luokkaan metodien ulkopuolella seuraavat vakiot:

• KIERROS_LKM = 6
  • Pituushyppykilpailun kierrosten lukumäärä
• HYLATTY = -100
  • Vakioarvo, jolla kuvataan hylättyä hyppyä.

Pituushyppaaja-oliolla on luokan yhteisten vakioiden lisäksi seuraavat kentät:

• __nimi
  • Pituushyppääjän nimi.
• __hypyt
  • Lista, joka sisältää hyppääjän tulokset eri kierroksilta (indeksillä 0 on kierroksen 1 tulos jne.) Jos hyppääjä ei ole vielä hypännyt jonkun kierroksen hyppyä, on listassa vastaavalla indeksillä arvo 0. Jos jonkun kierroksen hyppy on hylätty, on listassa vastaavalla indeksillä arvo -100 (vakio HYLATTY). Koska pituushyppykilpailussa tuloksia ei mitata alle senttimetrin tarkkuudella, ovat listan alkiot kokonaislukuja.

Kirjoita sitten luokkaan seuraavat metodit

• __init__(self, annettu_nimi)
  • Metodi luo uuden Pituushyppaaja-olion. Luotavan pituushyppajan nimi annetaan parametrina. Metodi myös luo listan tuloksia varten. Listan alkioiden arvoksi alustetaan 0.
• kerro_nimi(self)
  • Metodi palauttaa hyppääjän nimen
• kirjaa_tulos(self, kierros, tulos)
  • Metodi kirjaa tälle hyppäääjälle parametrina annetun tuloksen parametrina annetulta kierrokselta. Kirjaaminen onnistuu vain, jos hyppääjällä ei ole vielä tulosta tältä kierrokselta (joko hyväksyttyä tai hylättyä) ja annettu kierroksen numero on vähintään 1 ja korkeintaan KIERROS_LKM. Tällöin metodi palauttaa arvon True. Muussa tapauksessa tapauksessa metodi ei tee mitään ja palauttaa arvon False. Tuloksen järkevyyttä ei tarvitse tarkistaa. Voit olettaa, että metodin kutsuja antaa metodin viimeiseksi parametriksi arvon -100 (vakion HYLATTY), jos hyppy on hylätty.
• korjaa_tulos(self, kierros, tulos)
  • Metodi toimii muuten kuten kirjaa_tulos, mutta tämän metodin suoritus onnistuu myös silloin, kun hyppääjällä on jo tulos parametrina annetulta kierrokselta. Metodi on tarkoitettu virheellisesti kirjattujen tulosten korjaamiseen.
• kerro_tulos(self, kierros)
  • Metodi palauttaa hyppääjän tuloksen parametrina annetulta kierrokselta. Metodi palauttaa arvon 0, jos hyppääjä ei ole vielä hypännyt ko. kierroksen hyppyä ja arvon -100 (vakion HYLATTY), jos ko. kierroksen hyppy on hylatty.
• kerro_paras_tulos(self)
  • Metodi palauttaa hyppääjän parhaan tuloksen tähän asti. Jos hyppääjällä ei ole yhtään hyväksyttyä hyppyä (tai hän ei ole vielä hypännyt yhtään hyppyä) metodi palauttaa arvon 0.
• vertaa(self, toinen_hyppaaja)
  • Metodi tutkii, onko nykyinen hyppääjä huonompi, yhtä hyvä vai parempi kuin parametrina annettu pituushyppääjä. Metodi palauttaa arvon -1, jos nykyinen hyppääjä on huonompi, arvon 0, jos hyppääjät ovat yhtä hyviä ja arvon 1, jos nykyinen hyppääjä on parempi. Hyppääjien paremmuuden ratkaisee parhaan hypyn pituus. Jos hyppääjien parhaat hypyt ovat yhtä pitkiä, hyppääjät katsotaan yhtä hyviksi (toiseksi parhaita hyppyjä ei siis verrata, kuten oikeasti pituushyppykilpailuissa tehdään). Jos toisella hyppääjällä on hyväksytty hyppy ja toisella ei ole lainkaan hyväksyttyjä tai hypättyjä hyppyjä, hyväksytyn hypyn omaava hyppääjä katsotaan paremmaksi. Jos kummallakaan hyppääjällä ei ole hyväksyttyä hyppyä, hyppääjät katsotaan yhtä hyviksi.
• __str__(self)
  • Metodi palauttaa merkkijonon, joka sisältää hyppääjän nimen ja kaikkien kierrosten tulokset toisistaan pikulla erotettuina. Jos jonkun kierroksen hyppyä ei ole hyväksytty, tulee merkkjonoon kierroksen kohdalle X. Jos hyppääjä ei ole käyttänyt jonkun kierroksen hyppyä, tulee merkkojonoon kierroksen kohdalle viiva. Esimerkki:

    Teemu Teekkari, 765, X, -, -, -, -
    

Kun olet kirjoittanut luokan valmiiksi, voit testata sitä ajamalla valmiiksi kirjoitettua testiohjelmaa pituushyppaajia. Älä tee mitään muutoksia pituushyppaajia-ohjelmaan. Jos Eclipse valittaa virheistä tässä ohjelmassa, kysymys on todennäköisesti siitä, että sinun Pituushyppaaja-luokastasi puuttuu vielä sellaisia ominaisuuksia, joita pituushyppaajia-moduulin ohjelma käyttää.

Kun luokkasi näyttää toimivan oikein sitä testipääohjelmalla testatessa, palauta Gobliniin tiedosto pituushyppaaja.py.

Esimerkki testiohjelman suorituksesta:

[ohjelman suoritus alkaa]

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna hyppaajan nimi.
Teemu Teekkari

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna hyppaajan nimi.
Kirsti Kemisti

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna hyppaajan nimi.
Tepa Tarkka

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna hyppaajan nimi.
Rane Raksalainen

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
Anna kilpailijan numero.
1
Anna kierros.
1
Anna tulos (-100 on hylatty).
765
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
1
Anna hyppaajan nimi.
Britta Bittinikkari

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna kilpailijan numero.
2
Anna kierros.
1
Anna tulos (-100 on hylatty).
-100
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna kilpailijan numero.
3
Anna kierros.
1
Anna tulos (-100 on hylatty).
740
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna kilpailijan numero.
5
Anna kierros.
1
Anna tulos (-100 on hylatty).
615
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, 765, -, -, -, -, -
Kirsti Kemisti, X, -, -, -, -, -
Tepa Tarkka, 740, -, -, -, -, -
Rane Raksalainen, -, -, -, -, -, -
Britta Bittinikkari, 615, -, -, -, -, -

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
5
Paras tulos on 765 cm.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna kilpailijan numero.
1
Anna kierros.
2
Anna tulos (-100 on hylatty).
-100
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna kilpailijan numero.
2
Anna kierros.
2
Anna tulos (-100 on hylatty).
620
Uusi tulos kirjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
5
Paras tulos on 765 cm.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, 765, X, -, -, -, -
Kirsti Kemisti, X, 620, -, -, -, -
Tepa Tarkka, 740, -, -, -, -, -
Rane Raksalainen, -, -, -, -, -, -
Britta Bittinikkari, 615, -, -, -, -, -

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
3
Vertaillaan kahta kilpailijaa.

1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna 1. kilpailijan numero.
2
Anna 2. kilpailijan numero.
5
Ensimmainen kilpailija on parempi.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
2
1. Teemu Teekkari
2. Kirsti Kemisti
3. Tepa Tarkka
4. Rane Raksalainen
5. Britta Bittinikkari
Anna kilpailijan numero.
1
Anna kierros.
2
Anna tulos (-100 on hylatty).
721
Tuloksen kirjaus ei onnistunut.
Haluatko korjata vanhaa tulosta (k/e)?
k
Tulos korjattiin.

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
4
Teemu Teekkari, 765, 721, -, -, -, -
Kirsti Kemisti, X, 620, -, -, -, -
Tepa Tarkka, 740, -, -, -, -, -
Rane Raksalainen, -, -, -, -, -, -
Britta Bittinikkari, 615, -, -, -, -, -

Valitse toiminto:
1. luo uusi pituushyppaaja
2. kirjaa tulos
3. vertaa kahta hyppaajaa
4. tulosta hyppaajat ja tulokset
5. etsi paras tulos
6. lopeta
6
[ohjelman suoritus päättyy]

Värikoodit:
Sininen: Syöte käyttäjältä
Vihreä: Ohjelman tuloste
Punainen: Erityishuomatus: ei tulosteta