seedlingattempt/godot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #62083 from KoBeWi/string_slice'n_dice

Browse Source 
Improve usage of `String.split()` vs `get_slice()`
This commit is contained in:
Thaddeus Crews
2025-09-22 08:50:01 -05:00
parent 3ef19961cc d61a337a70
commit 94dbc42a56
17 changed files with 45 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
doc/classes/String.xml
View File

@ -332,7 +332,7 @@
<param index="1" name="slice" type="int" />
<description>
Splits the string using a [param delimiter] and returns the substring at index [param slice]. Returns the original string if [param delimiter] does not occur in the string. Returns an empty string if the [param slice] does not exist.
This is faster than [method split], if you only need one substring.
This is faster than [method split], if you only need one or two substrings.
[codeblock]
print("i/am/example/hi".get_slice("/", 2)) # Prints "example"
[/codeblock]
@ -343,6 +343,11 @@
<param index="0" name="delimiter" type="String" />
<description>
Returns the total number of slices when the string is split with the given [param delimiter] (see [method split]).
Use [method get_slice] to extract a specific slice.
[codeblock]
print("i/am/example/string".get_slice_count("/")) # Prints '4'.
print("i am example string".get_slice_count("/")) # Prints '1'.
[/codeblock]
</description>
</method>
<method name="get_slicec" qualifiers="const">
@ -351,7 +356,8 @@
<param index="1" name="slice" type="int" />
<description>
Splits the string using a Unicode character with code [param delimiter] and returns the substring at index [param slice]. Returns an empty string if the [param slice] does not exist.
This is faster than [method split], if you only need one substring.
This is faster than [method split], if you only need one or two substrings.
This is a Unicode version of [method get_slice].
</description>
</method>
<method name="hash" qualifiers="const">