summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorkobewi <kobewi4e@gmail.com>2022-01-16 02:11:30 +0100
committerkobewi <kobewi4e@gmail.com>2022-01-17 16:44:07 +0100
commit7bb682651f1dca4bc4a7a1b8ff67e6c9e288dc54 (patch)
treec123266451c69797413b8db46db30adf2e105a94
parent1cff9a2e49d42187d4e3729cddbaf7fdbcced0bd (diff)
Clarify to_float() and to_int() methods
-rw-r--r--doc/classes/String.xml15
1 files changed, 13 insertions, 2 deletions
diff --git a/doc/classes/String.xml b/doc/classes/String.xml
index d86c577e5e..c8e835f0f1 100644
--- a/doc/classes/String.xml
+++ b/doc/classes/String.xml
@@ -684,13 +684,24 @@
<method name="to_float" qualifiers="const">
<return type="float" />
<description>
- Converts a string containing a decimal number into a [code]float[/code].
+ Converts a string containing a decimal number into a [code]float[/code]. The method will stop on the first non-number character except the first [code].[/code] (decimal point), and [code]e[/code] which is used for exponential.
+ [codeblock]
+ print("12.3".to_float()) # 12.3
+ print("1.2.3".to_float()) # 1.2
+ print("12ab3".to_float()) # 12
+ print("1e3".to_float()) # 1000
+ [/codeblock]
</description>
</method>
<method name="to_int" qualifiers="const">
<return type="int" />
<description>
- Converts a string containing an integer number into an [code]int[/code].
+ Converts a string containing an integer number into an [code]int[/code]. The method will remove any non-number character and stop if it encounters a [code].[/code].
+ [codeblock]
+ print("123".to_int()) # 123
+ print("a1b2c3".to_int()) # 123
+ print("1.2.3".to_int()) # 1
+ [/codeblock]
</description>
</method>
<method name="to_lower" qualifiers="const">