using System;

/// @author vesal
/// @version 25.9.2012
/// <summary>
/// Esimerkkejä funktio-aliohjelmista
/// </summary>
public class Funktioita
{
    /// <summary>
    /// Kutsutaan funktioita
    /// </summary>
    /// <param name="args">ei käytössä</param>
    public static void Main(string[] args)
    {
        int a = 4;
        int b = 3;

        double  ka;

        ka = Keskiarvo(a, b);

        Console.WriteLine("Keskiarvo = " + ka);

        double ala;

        ala = YmpyranAla(3.0);
        Console.WriteLine("Keskiarvo = {0:000.0000} ja  ympyrän ala = {1:0.000}" ,ka, ala);
    }


    /// <summary>
    /// Laskee ympyrän alan
    /// </summary>
    /// <param name="r">ympyrän säde</param>
    /// <returns>pinta-alan</returns>
    /// <example>
    /// <pre name="test">
    ///    Funktioita.YmpyranAla(1) ~~~ 3.1415926; 
    ///    Funktioita.YmpyranAla(2) ~~~ 12.566370614; 
    /// </pre>
    /// </example>
    public static double YmpyranAla(double r)
    {
        return Math.PI * r * r;
    }


    /// <summary>
    /// Lasketaan kahden luvun keskiarvo.
    /// </summary>
    /// <param name="a">eka luku</param>
    /// <param name="b">toinen luku</param>
    /// <returns>lukujen keskiarvo</returns>
    /// <example>
    /// <pre name="test">
    ///   Funktioita.Keskiarvo(1,2) ~~~ 1.5;
    ///   Funktioita.Keskiarvo(0,2) ~~~ 1.0;
    ///   Funktioita.Keskiarvo(5,7) ~~~ 6.0;
    ///   Funktioita.Keskiarvo(-5,5) ~~~ 0.0;
    /// </pre>
    /// </example>
    public static double Keskiarvo(int a,int b)
    {
        return (a+b) / 2.0;
    }

}