153 lines
4.3 KiB
C
153 lines
4.3 KiB
C
/* rooster.h
|
|
|
|
Deze module verzorgt het datatype "rooster". Een rooster representeert een
|
|
rechthoekig grid van objecten. Elk object is in dit rooster een char.
|
|
|
|
Deze header file beschrijft het interface voor "rooster".
|
|
De implementatie, in "rooster.c", moet je grotendeels zelf schrijven.
|
|
*/
|
|
|
|
#ifndef _ROOSTER_H
|
|
#define _ROOSTER_H
|
|
|
|
#include <stdio.h>
|
|
|
|
// Dankzij de typedef hoef je niet telkens "struct rooster_data" te schrijven.
|
|
// Definieer struct rooster_data in rooster.c.
|
|
struct rooster_data;
|
|
typedef struct rooster_data rooster;
|
|
|
|
typedef enum {
|
|
BEGIN,
|
|
AAN_HET_SPELEN,
|
|
GEWONNEN,
|
|
VERLOREN
|
|
} toestand;
|
|
|
|
/* Maak een rooster op basis van de data in de gegeven stream.
|
|
|
|
fh: de stream waaruit het doolhof gelezen moet worden.
|
|
|
|
Uitvoer: als alles goed gaat, een pointer naar een rooster (die op de heap is
|
|
gealloceerd), dat overeenkomt met de gegeven beschrijving.
|
|
De begintoestand is BEGIN.
|
|
|
|
Als de beschrijving niet consistent is (bijvoorbeeld
|
|
niet alle rijen zijn even lang, of er klopt iets anders niet), of
|
|
als niet voldoende geheugen kan worden gereserveerd, dan wordt
|
|
NULL teruggegeven. (In dat geval blijft geen gereserveerd geheugen
|
|
achter.)
|
|
*/
|
|
rooster *rooster_lees(FILE *fh);
|
|
|
|
/*
|
|
* Maak een rooster op basis van een gegeven string.
|
|
*
|
|
* Uitvoer: als alles goed gaat, een pointer naar een rooster (die op de heap is
|
|
* gealloceerd), dat overeenkomt met de gegeven beschrijving.
|
|
* De begintoestand is BEGIN.
|
|
*
|
|
* Als de beschrijving niet consistent is (bijvoorbeeld
|
|
* niet alle rijen zijn even lang, of er klopt iets anders niet), of
|
|
* als niet voldoende geheugen kan worden gereserveerd, dan wordt
|
|
* NULL teruggegeven. (In dat geval blijft geen gereserveerd geheugen
|
|
* achter.)
|
|
*/
|
|
rooster *rooster_maak(char* template);
|
|
|
|
/* Vraag de huidige toestand van het spel op.
|
|
|
|
rp: een pointer naar het rooster.
|
|
|
|
Uitvoer: de toestand.
|
|
*/
|
|
toestand rooster_vraag_toestand(const rooster *rp);
|
|
|
|
|
|
/* Verander de huidige toestand van het spel.
|
|
|
|
rp: een pointer naar het rooster.
|
|
t: de nieuwe toestand.
|
|
*/
|
|
void rooster_zet_toestand(rooster *rp, toestand t);
|
|
|
|
|
|
/* Geef alle resources vrij die zijn gealloceerd voor een rooster.
|
|
De rooster pointer is na aanroep van deze functie niet meer bruikbaar.
|
|
|
|
rp: een pointer naar het rooster.
|
|
*/
|
|
void rooster_klaar(rooster *rp);
|
|
|
|
|
|
/* Vraag de breedte van het rooster op, dat wil zeggen, het aantal kolommen.
|
|
|
|
rp: een pointer naar het rooster.
|
|
|
|
Uitvoer: de breedte.
|
|
*/
|
|
int rooster_breedte(const rooster *rp);
|
|
|
|
|
|
/* Vraag de hoogte van het rooster op, dat wil zeggen, het aantal rijen.
|
|
|
|
rp: een pointer naar het rooster.
|
|
|
|
Uitvoer: de hoogte.
|
|
*/
|
|
int rooster_hoogte(const rooster *rp);
|
|
|
|
|
|
/* Kijk of de gegeven positie binnen het rooster valt.
|
|
|
|
rp: een pointer naar het rooster.
|
|
x,y: de positie.
|
|
|
|
Uitvoer: 1 als de positie binnen het rooster valt, anders 0.
|
|
*/
|
|
int rooster_bevat(const rooster *rp, int x, int y);
|
|
|
|
|
|
/* Kijk welk object er staat op een bepaalde positie in het rooster.
|
|
|
|
rp : een pointer naar het rooster
|
|
x,y: de betreffende positie.
|
|
|
|
Uitvoer: het object op die positie, of '\0' als de positie buiten het
|
|
rooster valt.
|
|
*/
|
|
char rooster_kijk(const rooster *rp, int x, int y);
|
|
|
|
|
|
/* Schrijf een bepaald object op een bepaalde positie in het rooster.
|
|
|
|
rp : een pointer naar het rooster
|
|
x,y: de betreffende positie.
|
|
c : het object.
|
|
|
|
Effect: als (x,y) binnen het rooster ligt, wordt het object op
|
|
de opgegeven positie geplaatst, anders verandert er niets.
|
|
|
|
Uitvoer: 1 als het object is geplaatst, of 0 als het buiten de grenzen lag.
|
|
*/
|
|
int rooster_plaats(rooster *rp, int x, int y, char c);
|
|
|
|
|
|
/* Zoek een bepaald object in het rooster, en geef de coordinaten van het
|
|
object terug via de gegeven pointers. Let op: als er meerdere objecten van
|
|
het gezochte soort in het rooster voorkomen, is niet gedefinieerd van welke
|
|
de positie wordt gevonden.
|
|
|
|
rp : een pointer naar het rooster
|
|
c : het object dat moet worden gezocht
|
|
x,y: pointers naar de geheugenlocaties waar de gevonden positie moet worden
|
|
geschreven.
|
|
|
|
Uitvoer: via de pointers x en y. Als het object niet wordt gevonden worden
|
|
*x en *y op -1 gezet.
|
|
*/
|
|
void rooster_zoek(const rooster *rp, char c, int *x, int *y);
|
|
|
|
|
|
#endif
|