Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
float
Вбудований тип для плавно-точкових чисел.
Опис
The float built-in type is a 64-bit double-precision floating-point number, equivalent to double in C++. This type has 14 reliable decimal digits of precision. The maximum value of float is approximately 1.79769e308, and the minimum is approximately -1.79769e308.
Many methods and properties in the engine use 32-bit single-precision floating-point numbers instead, equivalent to float in C++, which have 6 reliable decimal digits of precision. For data structures such as Vector2 and Vector3, Godot uses 32-bit floating-point numbers by default, but it can be changed to use 64-bit doubles if Godot is compiled with the precision=double option.
Math done using the float type is not guaranteed to be exact and will often result in small errors. You should usually use the @GlobalScope.is_equal_approx() and @GlobalScope.is_zero_approx() methods instead of == to compare float values for equality.
Note: In a boolean context, a float will evaluate to false if it's exactly equal to 0.0, and to true otherwise.
Посібники
Конструктори
float() |
|
float(from: String) |
|
Оператори
operator !=(right: float) |
|
operator !=(right: int) |
|
operator *(right: Color) |
|
Quaternion |
operator *(right: Quaternion) |
Vector2 |
operator *(right: Vector2) |
Vector2 |
operator *(right: Vector2i) |
Vector3 |
operator *(right: Vector3) |
Vector3 |
operator *(right: Vector3i) |
Vector4 |
operator *(right: Vector4) |
Vector4 |
operator *(right: Vector4i) |
operator *(right: float) |
|
operator *(right: int) |
|
operator **(right: float) |
|
operator **(right: int) |
|
operator +(right: float) |
|
operator +(right: int) |
|
operator -(right: float) |
|
operator -(right: int) |
|
operator /(right: float) |
|
operator /(right: int) |
|
operator <(right: float) |
|
operator <(right: int) |
|
operator <=(right: float) |
|
operator <=(right: int) |
|
operator ==(right: float) |
|
operator ==(right: int) |
|
operator >(right: float) |
|
operator >(right: int) |
|
operator >=(right: float) |
|
operator >=(right: int) |
|
Описи конструкторів
0.0.
Constructs a float як копія даної float.
float float(from: String)
Перетворення String в float, наступні ті ж правила, як String.to_float().
У ролях bool значення для плавучої точки значення float(true) буде дорівнює 1.0 і float(false) будуть рівні 0.0.
У ролях int значення до плаваючої точки значення float(1) будуть рівні 1.0.
Описи операторів
bool operator !=(right: float) 🔗
Повертає true, якщо два числа з рухомою комою відрізняються один від одного.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього оператора можуть бути неточними за наявності NaN-ів.
bool operator !=(right: int) 🔗
Повертає true, якщо значення цілого числа відрізняється від числа з плаваючою точкою.
Color operator *(right: Color) 🔗
Множить кожен компонент Color, включаючи альфа, на заданий float.
print(1.5 * Color(0.5, 0.5, 0.5)) # Prints (0.75, 0.75, 0.75, 1.5)
Quaternion operator *(right: Quaternion) 🔗
Множення кожного компонента Quaternion за умови float. Ця операція не має значення самостійно, але її можна використовувати в складі більшого виразу.
Vector2 operator *(right: Vector2) 🔗
Множить кожен компонент Vector2 на заданий float.
print(2.5 * Vector2(1, 3)) # Prints (2.5, 7.5)
Vector2 operator *(right: Vector2i) 🔗
Множить кожен компонент Vector2i на заданий float. Повертає Vector2.
print(0.9 * Vector2i(10, 15)) # Друкує (9.0, 13.5)
Vector3 operator *(right: Vector3) 🔗
Множення кожного компонента Vector3 заданими float.
Vector3 operator *(right: Vector3i) 🔗
Множить кожен компонент Vector3i на заданий float. Повертає Вектор3.
print(0.9 * Vector3i(10, 15, 20)) # Prints (9.0, 13.5, 18.0)
Vector4 operator *(right: Vector4) 🔗
Множення кожного компонента Vector4 заданими float.
Vector4 operator *(right: Vector4i) 🔗
Множить кожен компонент Vector4i на заданий float. Повертає Vector4.
print(0.9 * Vector4i(10, 15, 20, -10)) # Друкує (9.0, 13.5, 18.0, -9.0)
float operator *(right: float) 🔗
Множить два float.
float operator *(right: int) 🔗
Множиці float і int. Результатом є float.
float operator **(right: float) 🔗
Підводить число з float до степеня числа з float.
print(39.0625**0.25) # 2.5
float operator **(right: int) 🔗
Знімає float на потужність int. Результатом є float.
print (0.9***3) # 0.729
float operator +(right: float) 🔗
Додає дві плавки.
float operator +(right: int) 🔗
Додати float і int. Результатом є float.
float operator -(right: float) 🔗
Відстежуйте плавку з плавки.
float operator -(right: int) 🔗
Відстежуйте вміст з float. Результатом є float.
float operator /(right: float) 🔗
Дивиди дві плавки.
float operator /(right: int) 🔗
Дивиди float int. Результатом є float.
bool operator <(right: float) 🔗
Повертає true, якщо ліве число з рухомою комою менше від правого.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього оператора можуть бути неточними за наявності NaN-ів.
Повертає true, якщо цей float менше заданого int.
bool operator <=(right: float) 🔗
Повертає true, якщо ліве число з рухомою комою менше або дорівнює правому.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього оператора можуть бути неточними за наявності NaN-ів.
bool operator <=(right: int) 🔗
Повертає true, якщо цей float менший або дорівнює заданому int.
bool operator ==(right: float) 🔗
Повертає true, якщо обидва числа з рухомою комою точно рівні.
Примітка: У зв'язку з похибками чисел з рухомою комою, розгляньте використання @GlobalScope.is_equal_approx() або @GlobalScope.is_zero_approx(), що є більш надійними.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього оператора можуть бути неточними за наявності NaN-ів.
bool operator ==(right: int) 🔗
Повертає true, якщо float і вказане int рівні.
bool operator >(right: float) 🔗
Повертає true, якщо ліве число з рухомою комою більше правого.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього оператора можуть бути неточними за наявності NaN-ів.
Повертає true, якщо цей float більший за заданий int.
bool operator >=(right: float) 🔗
Повертає true, якщо ліве число з рухомою комою більше або дорівнює правому.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
bool operator >=(right: int) 🔗
Повертає true, якщо цей float більший або дорівнює вказаному int.
Повертає однакову вартість, якщо + не було. `` +`` нічого не робить, але іноді це може зробити ваш код більш читабельним.
Повертає негативне значення float. Якщо позитивне, то виходить число негативно. Якщо негативно, то виходить число позитивним. З поплавками число нуль може бути або позитивним або негативним.