<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its"
      type="guide"
      id="function">

    <info>
        <link type="guide" xref="index#equation"/>
    </info>

	<title>Functions</title>
    
    <p>
    Functions can be used by inserting the name of the function followed by function arguments. <app>Calculator</app> also support user-defined functions.
    If the argument is not a number or <link xref="variable">a single variable</link> then write each argument separated by semicolon and use parenthesis around the argument list.
    </p>
    <example>
    <p its:locNote="Translators: Do not translate the word 'sin'!">
    sin 30
    </p>
    <p its:locNote="Translators: Do not translate the word 'abs'!">
    abs (5−9)
    </p>
    <p its:locNote="Translators: Do not translate the word 'fun'!">
    fun (9;10)
    </p>
    </example>
    <p>
    To add a new function type the function in the format as given below. A function name and arguments must only contain upper or lower case characters. The part after @ is the function description which is optional.
    </p>
    <example>
    <p>
    SimpleInterest (principal; rate; time) = principal * rate * time @ Simple Interest formula
    </p>
    </example>
    <p>
    Functions can also be added and inserted using the f(x) button.
    </p>
    <example>
    <p>
    Click on f(x). Type the function name in the box, choose the number of arguments and click on the plus sign button next to it. On the calculator screen type the function expression and press <key>Enter</key>.
    </p>
    </example>
    <example>
    <p>
    Click on f(x). Choose the function and click on it.
    </p>
    </example>
    <p>
    The following functions are defined.
    </p>
    <table>
    <tr>
    <td><p its:translate="no">abs</p></td>
    <td><p><link xref="absolute">Absolute Value</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">ceil</p></td>
    <td><p>Ceiling</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">cos</p></td>
    <td><p><link xref="trigonometry">Cosine</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">cosh</p></td>
    <td><p><link xref="trigonometry">Hyperbolic Cosine</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">floor</p></td>
    <td><p>Floor</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">frac</p></td>
    <td><p>Fractional Component</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">int</p></td>
    <td><p>Integer Component</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">ln</p></td>
    <td><p><link xref="logarithm">Natural Logarithm</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">log</p></td>
    <td><p><link xref="logarithm">Logarithm</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">not</p></td>
    <td><p><link xref="boolean">Boolean NOT</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">ones</p></td>
    <td><p>Ones complement</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">round</p></td>
    <td><p>Round</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">sgn</p></td>
    <td><p>Signum</p></td>
    </tr>
    <tr>
    <td><p its:translate="no">sin</p></td>
    <td><p><link xref="trigonometry">Sine</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">sinh</p></td>
    <td><p><link xref="trigonometry">Hyperbolic Sine</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">sqrt</p></td>
    <td><p><link xref="power">Square Root</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">tan</p></td>
    <td><p><link xref="trigonometry">Tangent</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">tanh</p></td>
    <td><p><link xref="trigonometry">Hyperbolic Tangent</link></p></td>
    </tr>
    <tr>
    <td><p its:translate="no">twos</p></td>
    <td><p>Twos complement</p></td>
    </tr>
    </table>
</page>
