Zum Hauptinhalt springen
Version: latest - a1.156.0 ⚖️

math

Diese Bibliothek stellt grundlegende mathematische Funktionen bereit. Sie stellt alle ihre Funktionen und Konstanten innerhalb der Tabelle math zur Verfügung.


🎒 Examples​

-- Rounding
local a = math.floor(3.7) -- 3
local b = math.ceil(3.2) -- 4

-- Random numbers
local chance = math.random() -- float between 0 and 1
local dice = math.random(1, 6) -- integer between 1 and 6

-- Min, Max and Absolute
local lowest = math.min(10, 5, 8) -- 5
local distance = math.abs(-250) -- 250

-- Trigonometry works with radians
local sine = math.sin(math.rad(90)) -- 1.0

🗼 Static Properties​

ValueName
3.141592653589793math.pi
2^1024math.huge

🗿 Static Functions​

ReturnsNameDescription
numberceilReturns the smallest integer greater than or equal to the given value
numbertanGibt den Tangenswert für einen gegebenen Wert im Bogenmaß zurück.
numberminGibt den Minimalwert aus einer Liste von Argumenten variabler Länge zurück
numberfmodGibt den Rest der Division von base durch modulator zurück, wobei der Quotient gegen Null gerundet wird
numberexpGibt e (die Basis des natürlichen Logarithmus) potenziert mit exponent zurück
numberrandomErzeugt pseudozufällige Zahlen mit gleichmäßiger Verteilung
numberradKonvertiert von Grad in Bogenmaß
numbersinGibt den Sinuswert für einen gegebenen Wert im Bogenmaß zurück.
numbercosGibt den Kosinuswert für einen gegebenen Wert im Bogenmaß zurück.
numberasinGibt den Arkussinus im Bogenmaß des angegebenen Werts zurück.
randomseedSetzt einen Startwert für den Pseudozufallsgenerator: Gleiche Startwerte erzeugen gleiche Zahlenfolgen
numberfloorReturns the largest integer less than or equal to the given value
numbermaxGibt den Maximalwert aus einer Liste von Argumenten variabler Länge zurück
numberatanReturns the arc tangent in radians. Pass y and x to get the angle of the point (x, y), using the signs of both to find the quadrant
numberacosGibt den Arcuscosinus im Bogenmaß des angegebenen Werts zurück.
numberabsGibt den absoluten, nicht-negativen Wert einer gegebenen Zahl zurück
numberlogReturns the logarithm of x in the given base. The default base is e (natural logarithm)
number, numbermodfGibt den ganzzahligen und den gebrochenen Teil der angegebenen Zahl zurück
numberdegKonvertiert von Bogenmaß in Grad
numbersqrtGibt die Quadratwurzel einer gegebenen Zahl zurück. Nur nicht-negative Argumente sind erlaubt

ceil​

Returns the smallest integer greater than or equal to the given value
local ret = math.ceil(number)

Parameters

TypeParameterDefaultDescription
numbernumber Required parameter Die Zahl, die aufgerundet werden soll.

Returns

TypeDescription
numberThe rounded up integer

tan​

Gibt den Tangenswert für einen gegebenen Wert im Bogenmaß zurück.
local ret = math.tan(value)

Parameters

TypeParameterDefaultDescription
numbervalue Required parameter Winkel im Bogenmaß

Returns

TypeDescription
numberThe tangent

min​

Gibt den Minimalwert aus einer Liste von Argumenten variabler Länge zurück
local ret = math.min(numbers...)

Parameters

TypeParameterDefaultDescription
varargs of numbernumbers... Required parameter Zahlen, um den kleinsten Wert zu ermitteln.

Returns

TypeDescription
numberThe smallest value

fmod​

Gibt den Rest der Division von base durch modulator zurück, wobei der Quotient gegen Null gerundet wird
local ret = math.fmod(base, modulator)

Parameters

TypeParameterDefaultDescription
numberbase Required parameter Der Basiswert.
numbermodulator Required parameter Der Modulator.

Returns

TypeDescription
numberThe remainder

exp​

Gibt e (die Basis des natürlichen Logarithmus) potenziert mit exponent zurück
local ret = math.exp(exponent)

Parameters

TypeParameterDefaultDescription
numberexponent Required parameter Der Exponent für die Funktion.

Returns

TypeDescription
numbere raised to the given power

random​

Erzeugt pseudozufällige Zahlen mit gleichmäßiger Verteilung
local ret = math.random(m, n)

Parameters

TypeParameterDefaultDescription
numberm Required parameter Wenn m der einzige Parameter ist: obere Grenze. Wenn n ebenfalls angegeben ist: untere Grenze. Falls angegeben, muss dies eine ganze Zahl sein.
numbern Required parameter Obere Grenze. Falls angegeben, muss dies eine ganze Zahl sein.

Returns

TypeDescription
numberA random float between 0 and 1 when called without parameters, otherwise a random integer in the given range

rad​

Konvertiert von Grad in Bogenmaß
local ret = math.rad(degrees)

Parameters

TypeParameterDefaultDescription
numberdegrees Required parameter Der Winkel gemessen in Grad.

Returns

TypeDescription
numberThe angle in radians

sin​

Gibt den Sinuswert für einen gegebenen Wert im Bogenmaß zurück.
local ret = math.sin(number)

Parameters

TypeParameterDefaultDescription
numbernumber Required parameter Winkel im Bogenmaß

Returns

TypeDescription
numberThe sine

cos​

Gibt den Kosinuswert für einen gegebenen Wert im Bogenmaß zurück.
local ret = math.cos(number)

Parameters

TypeParameterDefaultDescription
numbernumber Required parameter Winkel im Bogenmaß

Returns

TypeDescription
numberThe cosine

asin​

Gibt den Arkussinus im Bogenmaß des angegebenen Werts zurück.
local ret = math.asin(normal)

Parameters

TypeParameterDefaultDescription
numbernormal Required parameter Sinuswert im Bereich von -1 bis 1.

Returns

TypeDescription
numberThe angle in radians

randomseed​

Setzt einen Startwert für den Pseudozufallsgenerator: Gleiche Startwerte erzeugen gleiche Zahlenfolgen
math.randomseed(seed)

Parameters

TypeParameterDefaultDescription
numberseed Required parameter Der neue Startwert

floor​

Returns the largest integer less than or equal to the given value
local ret = math.floor(number)

Parameters

TypeParameterDefaultDescription
numbernumber Required parameter Die Zahl, die abgerundet werden soll.

Returns

TypeDescription
numberThe rounded down integer

max​

Gibt den Maximalwert aus einer Liste von Argumenten variabler Länge zurück
local ret = math.max(numbers...)

Parameters

TypeParameterDefaultDescription
varargs of numbernumbers... Required parameter Zahlen, um den größten Wert zu ermitteln

Returns

TypeDescription
numberThe largest value

atan​

Returns the arc tangent in radians. Pass y and x to get the angle of the point (x, y), using the signs of both to find the quadrant
local ret = math.atan(normal)

Parameters

TypeParameterDefaultDescription
numbernormal Required parameter Tangenswert.

Returns

TypeDescription
numberThe angle in radians

acos​

Gibt den Arcuscosinus im Bogenmaß des angegebenen Werts zurück.
local ret = math.acos(cos)

Parameters

TypeParameterDefaultDescription
numbercos Required parameter Kosinuswert im Bereich von -1 bis 1.

Returns

TypeDescription
numberThe angle in radians

abs​

Gibt den absoluten, nicht-negativen Wert einer gegebenen Zahl zurück
local ret = math.abs(x)

Parameters

TypeParameterDefaultDescription
numberx Required parameter Die Zahl, deren absoluten Wert wir erhalten möchten.

Returns

TypeDescription
numberThe absolute value

log​

Returns the logarithm of x in the given base. The default base is e (natural logarithm)
local ret = math.log(x, base)

Parameters

TypeParameterDefaultDescription
numberx Required parameter Der Wert, von dem die Basis des Exponenten ermittelt werden soll.
numberbase Required parameter Die logarithmische Basis.

Returns

TypeDescription
numberThe logarithm

modf​

Gibt den ganzzahligen und den gebrochenen Teil der angegebenen Zahl zurück
local ret_1, ret_2 = math.modf(base)

Parameters

TypeParameterDefaultDescription
numberbase Required parameter Der Basiswert.

Returns

TypeDescription
numberThe integral part
numberThe fractional part

deg​

Konvertiert von Bogenmaß in Grad
local ret = math.deg(radians)

Parameters

TypeParameterDefaultDescription
numberradians Required parameter Wert, der in Grad umgewandelt werden soll.

Returns

TypeDescription
numberThe angle in degrees

sqrt​

Gibt die Quadratwurzel einer gegebenen Zahl zurück. Nur nicht-negative Argumente sind erlaubt
local ret = math.sqrt(value)

Parameters

TypeParameterDefaultDescription
numbervalue Required parameter Wert, dessen Quadratwurzel berechnet werden soll.

Returns

TypeDescription
numberThe square root