文字列は非常に単純なデータ型であり、コピーオンライトという方式が取られています。
参照渡しができない型の場合、他の変数に渡すとすぐに複製されますが、Godot Engineの場合、渡された時点では参照渡しであり、変更があった場合に複製されます。
つまり、変更がない場合は複製されないのでメモリの節約になります。
また、Godot Engineでは文字列を加工するメソッドが多数用意されています。
Godot EngineはUnicodeをサポートしています。
文字列を作成するには、文字列リテラルを使用し、ダブルクォーテーション""でくくります。
var value :String = "あいうえお" # あいうえお
文字列リテラルでダブルクォーテーションを使用しているため、文字列内にダブルクォーテーションを使用することができません。
その場合、エスケープ文字を使い、\"と記述します。
var value :String = "\"かきくけこ\"" # "かきくけこ"
ほとんどの型をStringに変換することができますが、Stringクラスで変換するわけではありません。
String(100)などとするとエラーが出ます。
str(100)
var_to_str(100)
連結演算子+または+=を使用して、複数の文字列を連結します。
var value :String = "あいう" + "え" # あいうえ
value += "お" # あいうえお
他の型と連結する場合は、どちらも文字列に揃える必要があります。
var value :String = "あいうえお"
value += str(100)
print(value) # あいうえお100
文字列が同じかどうかを比較する場合、==等価演算子を使用することができます。
var value = "あいう" == "あいう" # true
また、文字コードの大小を、<または>の比較演算子を使用することで判別できます。
var value1 = "あ" < "い" # true
var value2 = "う" < "い" # false
文字列を数えるメソッドをご紹介します。
var value = "あいうえお"
print(value.length()) # 5
var value = "ねこねここねこ"
print(value.count("こ")) # 4
文字列の途中から、または途中までなどの範囲で探すことも可能です。
var value = "ねこねここねこ"
print(value.count("こ", 2, 5)) # 2
上記の例だと、最初の「ね」は0文字目と扱い、2文字目から5文字目までなので、
「ねこねここねこ」の範囲になります。
var value1 = "あいうえお"
print(value1.empty()) # false
var value2 = ""
print(value2.empty()) # true
var value = "あいうえお"
print(value.begin_with("あ")) # true
print(value.begin_with("お")) # false
var value = "あいうえお"
print(value.ends_with("あ")) # false
print(value.ends_with("お")) # true
var value1:String = "あいう%s"
print(value1 % "えお") # あいうえお
var value2:String = "%sいうえ%s"
print(value2 % ["あ", "お"]) # あいうえお
var value:String = "かきく{str}"
print(value.format({"str": "けこ"})) # かきくけこ
format()を使用すると、辞書に定義されたキーとペアになった文字列に置換されます。
例えば、リッチテキストを使用することを前提として、メッセージ内に画像を表示させるタグに置き換えることも可能です。
var dict :Dictionary = {"Aボタン画像":"[img]res://icon.png[/img]"}
var value :String = "{Aボタン画像}ボタン"
$RichTextLabel.bbcode_enabled = true
$RichTextLabel.text = value.format(dict) # 🅰️ボタン
最終的に文字列に変換されますが、変換元は数値を扱います。
print("%010d" % 555) # 0000000555
print("%05d" % 555) # 00555