# Difference between revisions of "Blitz:Numerical Functions"

(Created page with "Blitz Basic / AmiBlitz provides many numerical functions to evaluate certain properties or carry out certain mathematical operations. Most of these will be very familiar to an...") |
|||

Line 1: | Line 1: | ||

− | Blitz Basic / AmiBlitz provides many numerical functions to evaluate certain properties or carry out certain mathematical operations. Most of these will be very familiar to anyone who has programmed before. | + | Blitz Basic / AmiBlitz provides many numerical functions to evaluate certain properties or carry out certain mathematical operations. Most of these will be very familiar to anyone who has programmed before. Note that in the examples given, numbers are used as the inputs for clarity, however a variable or expression can always be used instead. |

==Basic Arithmetic== | ==Basic Arithmetic== | ||

The simplest numerical operations are the basic mathematical functions such as add and subtract. These are used in an expression using + for add, - for subtract, * for multiply and / for divide: | The simplest numerical operations are the basic mathematical functions such as add and subtract. These are used in an expression using + for add, - for subtract, * for multiply and / for divide: | ||

<code>a = 2 + 5 ; a is 7 | <code>a = 2 + 5 ; a is 7 | ||

+ | |||

b = 3 - 5 ; b is -2 | b = 3 - 5 ; b is -2 | ||

+ | |||

c = 2 * 8 ; c is 16 | c = 2 * 8 ; c is 16 | ||

+ | |||

d = 10 / 2 ; d is 5</code> | d = 10 / 2 ; d is 5</code> | ||

Blitz follows the standard conventional order used in the real world for carrying out the calculation: | Blitz follows the standard conventional order used in the real world for carrying out the calculation: | ||

Line 14: | Line 17: | ||

Calculations are evaluated going from left to right with operators of equal priority as normal. Placing brackets around any expression allows you to change the normal priority: | Calculations are evaluated going from left to right with operators of equal priority as normal. Placing brackets around any expression allows you to change the normal priority: | ||

<code>a = 3 + 2 * 5 ; a is 13 | <code>a = 3 + 2 * 5 ; a is 13 | ||

+ | |||

b = (3 + 2) * 5 ; b is 25</code> | b = (3 + 2) * 5 ; b is 25</code> | ||

+ | It is also possible to nest bracketed expressions, with the innermost brackets getting the highest priority. | ||

+ | |||

+ | Powers are represented by the ^ symbol: | ||

+ | <code>a = 2 ^ 3 ; a is 8</code> | ||

+ | |||

+ | ==Fractions / Floats== | ||

+ | Fractions are called floating point numbers in computer terms. Only certain [[Blitz:Data types|variable types]] can store floating point numbers. More details on [[Blitz:Data types|variable types]] are available at the linked page, but for now just remember that if a float is stored in a variable that can only store integers, it will not cause an error. Instead, the fractional part is simply lost. This can be a source of much confusion as it can cause bugs that only occur in certain circumstances and are very hard to track down! | ||

+ | <code>a.f = 5 / 2 ; a is a floating point variable and holds the value 2.5 | ||

+ | |||

+ | b.w = 5 / 2 ; b is a word (integer) variable and holds the value 2</code> | ||

+ | Basically, if you need the fractional part of a calculation, ensure the relevant variables are of a suitable type. | ||

+ | |||

+ | ==Trigonometry== | ||

+ | Blitz includes a number of functions for carrying out trigonometric calculations. These are useful for certain curve and3D calculations, but can be slow to execute. | ||

+ | |||

+ | The basic functions are Sin(), Cos() and Tan(), which return the sin cos and tan of the given value. All parameters are floats, and all values returned are floats too - naturally enough if you don't use a float for the returned value, all you'll get is either 0 or 1: | ||

+ | <code>a.f = Sin(27) ; a is 0.45399...... | ||

+ | |||

+ | b.w = Cos(45) ; b is 0 (would be 0.7071.... but an integer type was used for the result)</code> | ||

+ | |||

+ | The functions ASin(), ACos() and ATan() are the ArcSin, ArcCos and ArcTan equivalents of the Sin(), Cos() and Tan() functions. HSin(), HCos() and HTan() are the hyperbolic Sin, Cos and Tan equivalents. | ||

+ | |||

+ | ==More Arithmetic== | ||

+ | Square roots are calculated using the Sqr() function: | ||

+ | <code>a.f = Sqr(27) ; a is 9</code> | ||

+ | |||

+ | The Exp() function returns the e value raised to the power of the given argument: | ||

+ | <code>a.f = Exp(5) ; a is 148.413....</code> | ||

+ | The inverse of this is the Log() function, which returns the natural log (base e) of the given value: | ||

+ | <code>a.f = Log(20) ; a is 2.9957.....</code> | ||

+ | The base 10 equivalent is the Log10() function. | ||

+ | |||

+ | ==Other Functions== | ||

+ | To get the absolute value of a number, use the Abs() function. This simply removes any negative sign from the number: | ||

+ | <code>a = Abs(10) ; a is 10 | ||

+ | |||

+ | b = Abs(-10) ; b is also 10</code> | ||

+ | Int() and Frac() return the integer and fractional sections of a float: | ||

+ | <code>a.f = Int(3.14) ; a is 3 | ||

+ | |||

+ | b.f = Frac(3.14) ; b is 0.14</code> | ||

+ | |||

+ | Alternative "quick" versions of the Abs() and Frac() functions are available. These are faster to execute than the standard commands on non-FPU systems, but are limited to using the quick variable type. They may also be slower than the floating equivalents on an FPU-equipped machine. These functions are QAbs() and QFrac(). | ||

+ | |||

+ | Random numbers can be generated using the Rnd() function. With no arguments, this returns a fractional number between 0 and 1. With an argument, this returns a value between 0 and the number given: | ||

+ | <code> a.f = rnd() ; a is somewhere between 0 and 1 | ||

+ | |||

+ | b.f = rnd(6) ; b is a float between 0 and 6, e.g. 2.264 | ||

+ | |||

+ | c.b = rnd(6) ; c is a random integer between 0 and 5 inclusive, since the fractional part is dropped for an integer type</code> | ||

+ | Wrapping and limiting numbers based on a given range can be done using the QWrap and QLimit functions. These can only be used on quick types: | ||

+ | <code> | ||

+ | </code> | ||

[[Category:Blitz Basic / AmiBlitz|Blitz]] | [[Category:Blitz Basic / AmiBlitz|Blitz]] |

## Revision as of 10:56, 9 October 2015

Blitz Basic / AmiBlitz provides many numerical functions to evaluate certain properties or carry out certain mathematical operations. Most of these will be very familiar to anyone who has programmed before. Note that in the examples given, numbers are used as the inputs for clarity, however a variable or expression can always be used instead.

## Basic Arithmetic

The simplest numerical operations are the basic mathematical functions such as add and subtract. These are used in an expression using + for add, - for subtract, * for multiply and / for divide:
```
a = 2 + 5 ; a is 7
```

```
b = 3 - 5 ; b is -2
```

```
c = 2 * 8 ; c is 16
```

`d = 10 / 2 ; d is 5`

Blitz follows the standard conventional order used in the real world for carrying out the calculation:

- Brackets
- Powers
- Multiplication & Division
- Addition and Subtraction

Calculations are evaluated going from left to right with operators of equal priority as normal. Placing brackets around any expression allows you to change the normal priority:
```
a = 3 + 2 * 5 ; a is 13
```

`b = (3 + 2) * 5 ; b is 25`

It is also possible to nest bracketed expressions, with the innermost brackets getting the highest priority.

Powers are represented by the ^ symbol:
`a = 2 ^ 3 ; a is 8`

## Fractions / Floats

Fractions are called floating point numbers in computer terms. Only certain variable types can store floating point numbers. More details on variable types are available at the linked page, but for now just remember that if a float is stored in a variable that can only store integers, it will not cause an error. Instead, the fractional part is simply lost. This can be a source of much confusion as it can cause bugs that only occur in certain circumstances and are very hard to track down!
```
a.f = 5 / 2 ; a is a floating point variable and holds the value 2.5
```

`b.w = 5 / 2 ; b is a word (integer) variable and holds the value 2`

Basically, if you need the fractional part of a calculation, ensure the relevant variables are of a suitable type.

## Trigonometry

Blitz includes a number of functions for carrying out trigonometric calculations. These are useful for certain curve and3D calculations, but can be slow to execute.

The basic functions are Sin(), Cos() and Tan(), which return the sin cos and tan of the given value. All parameters are floats, and all values returned are floats too - naturally enough if you don't use a float for the returned value, all you'll get is either 0 or 1:
```
a.f = Sin(27) ; a is 0.45399......
```

`b.w = Cos(45) ; b is 0 (would be 0.7071.... but an integer type was used for the result)`

The functions ASin(), ACos() and ATan() are the ArcSin, ArcCos and ArcTan equivalents of the Sin(), Cos() and Tan() functions. HSin(), HCos() and HTan() are the hyperbolic Sin, Cos and Tan equivalents.

## More Arithmetic

Square roots are calculated using the Sqr() function:
`a.f = Sqr(27) ; a is 9`

The Exp() function returns the e value raised to the power of the given argument:
`a.f = Exp(5) ; a is 148.413....`

The inverse of this is the Log() function, which returns the natural log (base e) of the given value:
`a.f = Log(20) ; a is 2.9957.....`

The base 10 equivalent is the Log10() function.

## Other Functions

To get the absolute value of a number, use the Abs() function. This simply removes any negative sign from the number:
```
a = Abs(10) ; a is 10
```

`b = Abs(-10) ; b is also 10`

Int() and Frac() return the integer and fractional sections of a float:
```
a.f = Int(3.14) ; a is 3
```

`b.f = Frac(3.14) ; b is 0.14`

Alternative "quick" versions of the Abs() and Frac() functions are available. These are faster to execute than the standard commands on non-FPU systems, but are limited to using the quick variable type. They may also be slower than the floating equivalents on an FPU-equipped machine. These functions are QAbs() and QFrac().

Random numbers can be generated using the Rnd() function. With no arguments, this returns a fractional number between 0 and 1. With an argument, this returns a value between 0 and the number given:
```
a.f = rnd() ; a is somewhere between 0 and 1
```

```
b.f = rnd(6) ; b is a float between 0 and 6, e.g. 2.264
```

`c.b = rnd(6) ; c is a random integer between 0 and 5 inclusive, since the fractional part is dropped for an integer type`

Wrapping and limiting numbers based on a given range can be done using the QWrap and QLimit functions. These can only be used on quick types:
```
```