h1. Funktiot

Funktio on itsenäinen ohjelman osa, joka tekee jonkin halutun tehtävän, se voi esimerkiksi laskea jonkin laskutoimituksen. Funktioiden avulla voidaan selkeyttää koodia, sillä ne eriyttävät tietyn toiminnon omaksi kokonaisuudekseen, jota voidaan tarvittaessa kutsua.

Funktioista puhuttaessa voidaan erottaa kaksi tasoa:
* Toisaalta on olemassa valmiita kirjastofunktioita, jotka ovat kaikkien ohjelmoijien käytössä. Esim [debugPrint|RobotC - debugPrint].
* Toisaalta jokainen ohjelmoija voi kirjoittaa funktioita omaan käyttöönsä.

h2. Funktion kirjoittaminen

Funktion täydellinen nimi koostuu kolmesta asiasta:
# paluuarvon *tyypistä* (pakollinen\!)
# funktion *nimestä* (pakollinen\!)
# _parametreista_ (ei pakollisia, riippuu käyttötarkoituksesta)

{code}
paluuarvon_tyyppi funktion_nimi(
	p1_tyyppi param1,
	/* ... */
	pn_tyyppi paramn)
{
    // Funktion koodi tänne
}
{code}

{note}Funktiot kannattaa kirjoittaa {{task 

Funktiot kannattaa kirjoittaa task main()

:in

yläpuolelle.

{note}

h2. Funktiotyypit

Funktioita voidaan tehdä erilaisia:

* [Ei parametreja - ei paluuarvoa|#esim1]
* [Parametri - ei paluuarvoa|#esim2]
* [Parametri ja paluuarvo|#esim4]

{anchor:esim1}

h3. Esimerkki 1

Esimerkissä on toteutettu funktio {{AjaEteenpain()}}. !funktiot_1.png|border=0!

Esimerkin mukainen funktio ajaisi moottoreita B ja C 50% teholla eteenpäin, jonka jälkeen pysäyttäisi moottorit.

h2. Funktion kutsuminen

Funktiota kutsutaan muodossa *funktion_nimi()* ja sulkujen sisään tulevat mahdolliset parametrit.

Esimerkin 1 funktion kutsuminen pääohjelmasta:
{code}
task main()              // pääohjelma
{
    AjaEteenpain();     // funktion kutsu
}
{code}

{note}Funktiota voidaan kutsua mistä tahansa ohjelmasta, myös funktiosta itsestään (kts. [rekursio|http://fi.wikipedia.org/wiki/Rekursio]).{note}

{anchor:esim2}

h2. Funktion parametrit

Funktioille voidaan myös välittää tietoa kutsun yhteydessä. Tämä tapahtuu funktion parametrien välityksellä. Jos funktiolle on määritelty parametreja, *ne on pakko antaa funktiota kutsuttaessa.*

h3. Esimerkki 2 !funktiot_2.png|border=0!

Edellä oleva funktio ottaa parametrikseen yhden kokonaisluvun, ajan.

{anchor:esim3}

h3. Esimerkki 3 !funktiot_3.png|border=0!

Edellä oleva funktio ottaa parametreikseen kaksi kokonaislukua, ajan ja moottoreiden nopeuden.

h2. Funktion paluuarvo

Funktio voi päätyttyään palauttaa kutsujalleen tietoa. Tieto palautetaan {{return}}\-käskyllä. Funktiossa voi olla useita {{return}}\-lauseita sopivissa kohdissa. Jokainen niistä poistuu funktiosta siinä kohdassa missä {{return}} on. Funktion nimen edessä oleva tyyppi määrää paluuarvon tyypin ja siksi {{return}}\-lauseen perässä olevan arvon pitää olla samaa tyyppiä (joko vakio tai muuttuja).

{anchor:esim4}

h3. Esimerkki 4 !funktiot_4.png|border=0!


Esimerkissä funktio {{SensorinArvo()}} palauttaa sensorin {{S1}} lukeman.

{anchor:esim5}

h3. Esimerkki 5 !funktiot_5.png|border=0!


Esimerkissä funktio {{SensorinArvo(int portti)}} palauttaa parametrin portti määrittelemän sensorin lukeman.

h3. Esimerkki 6 monta kutsua pääohjelmasta

Esimerkissä funktio {{SensorinArvo(int portti)}} palauttaa parametrin portti määrittelemän sensorin lukeman.

h2. Paikalliset muuttujat

Funktioilla voi olla omia paikallisia (_local

Funktiota voidaan kutsua mistä tahansa ohjelmasta, myös funktiosta itsestään (kts. rekursio).

_) muuttujia.

{code}
void funktio(int x)
{
    int y;

    // ...
}
{code}
* {{x}} on funktion parametri ja {{y}} funktion paikallinen muuttuja. On huomattava, että parametrit ja paikalliset muuttujat eivät näy funktion ulkopuolelle, eivätkä siten ole käytettävissä muualla kuin funktiossa itsessään.
* On myös tärkeää huomata, että eri funktioissa voi olla samannimisiä muuttujia ja ne ovat toisistaan täysin