String関数

String関数は、String全体の大文字への変換やStringからの空白の削除など、様々なアクションをStringに対して実行します。

次の表では、「変換」でサポートしているString関数について説明します。これらと同じ関数が変換APIリファレンス(Groovydoc)で説明されています。

次の表では、「変換」でサポートしているString関数について説明します。

ユーザー関数	戻り値のデータ型	説明
`concat(String... arguments)`	`String`	String引数のリストを連結して単一のStringを作成します。
`concatWithToken(String joinToken, String... arguments)`	`String`	結合トークンを使用してString引数のリストを連結して単一のStringを作成します。たとえば、`concatWithToken("\|", "merlot", "cabernet", "malbec")`の場合、`"merlot\|cabernet\|malbec"`を返します。
`contains(String originalString, String substring)`	`Boolean`	Stringに部分文字列が含まれるかどうかを確認します。たとえば、`contains("Boston", "Bos")`の場合、`true`を返します。
`find(String originalString, String substring)`	`String`、`null`	String内の部分文字列または正規表現の最初の出現箇所を返します。一致が見つからない場合は、`null`を返します。
`findAll(String originalString, String substring)`	`String`、`null`	String内で見つかった正規表現(String書式)のすべての出現箇所のリスト(空の可能性もあります)を返します。
`initRNG()`	`String`	初期化されたStringを返します。
`indexOf(String originalString, String substring)`	`int`	String内の部分文字列の索引を返します。
`isDate(String originalString, String dateFormat)`	`Boolean`	Stringが指定した書式の有効なDate値であるかどうかを確認します。
`isDouble(String s)`	`Boolean`	Stringが`double`であるかどうかを確認します。
`isInteger(String s)`	`Boolean`	Stringが`int`であるかどうかを確認します。
`isLong(String s)`	`Boolean`	Stringが`long`であるかどうかを確認します。
`length(String s)`	`int`	Stringの長さを返します。
`replace(String originalString, String oldExpression, String newString)`	`String`	String内の部分文字列または正規表現のすべてのインスタンスを新しいテキスト文字列に置き換えます。
`stripIndent(String s)`	`String`	Stringから先頭のスペースを削除します。
`substring(String s, int start int end)`	`String`	元のStringから開始ポイントと終了ポイントに基づいて部分文字列を返します。たとえば、`substring("cabernet", 0, 2)`の場合、`"cab"`を返します。
`substring(String s, int start)`	`String`	元のStringから開始ポイントに基づいて部分文字列を返します。返される部分文字列は、開始ポイントから元のStringの最後までです。たとえば、`substring("cabernet", 5)`の場合、`"net"`を返します。
`toLowerCase(String s, String locale)`	`String`	Stringを小文字に変換します。オプションとしてStringのロケールを指定できます。これは、`"en"`にデフォルト設定されています。
`toTitleCase(String s, String locale)`	`String`	Stringをタイトルの大文字小文字に変換します。たとえば、`toTitleCase("sOMe STrING")`の場合、`"Some String"`を返します。オプションとしてStringのロケールを指定できます。これは、`"en"`にデフォルト設定されています。注意: スペースが含まれないカンマ区切り値のリストの場合、リスト内の最初の項目のみがタイトルの大文字小文字に変換されます。たとえば、`toTitleCase("apple,cherry,plum")`の場合、`"Apple,cherry,plum"`を返します。
`toUpperCase(String s, String locale)`	`String`	Stringを大文字に変換します。オプションとしてStringのロケールを指定できます。これは、`"en"`にデフォルト設定されています。
`trim(String s)`	`String`	Stringから先頭および末尾の空白を削除します。