# RuLa Functions

### Definition

A RuLa function is essentially an expression that performs a task or calculation and then returns one value. The calculation is defined in the function's body. If parameters (or arguments) are required to perform the calculation, they can be passed to the function in parenthesis.
Functions are useful if a task needs to be performed repeatedly at different places in the configuration. Once defined correctly, a function can be used over and over again without having to thinking about the complicated calculation.

### Examples

Each function needs a name and a body expression and they can take none as well as one or more parameters.

#### Without parameters

function say_hello():
'Hello everybody'
end
This function returns whatever is stated in its body, in this case 'Hello everybody'.
function half_a_dozen():
12/2
end
This function will return the number 6.

#### With one parameter

function divide_by_two(number):
number/2
end
The number that is passed to this function as a parameter is divided by two and then returned as a result. So `divide_by_two(30)` would return `15`.

#### With multiple parameters

function introduce(first_name, last_name):
'My name is ' + last_name + ' but you can call me ' + first_name
end
In the case of introduce(James, Bond) this would return the string 'My name is Bond but you can call me James".
Within the function's body, other functions can be used, both functions that already exist in Atfinity or the ones that were defined by the user.
function replace_element(some_list, element_to_replace, replacement):
map(
some_list,
if
CURRENT = number_to_replace then
replacement
else CURRENT
end
)
end
This function uses the map function in its body to replace all occurrences of a specific element in that list with a specified replacement. So writing `replace_number([8, 5, 8], 8, 0)` would return `[0, 5, 0]`.