ユニット core.string

最終公開日 : Sep 28, 2026
文字列操作機能を提供するスクリプトユニット。
メソッド
function capitalize(str: string): string 文字列の最初の文字を Character.toTitleCase(Number) に従ってタイトルケースに変更して大文字にします。
function contains(value: string, searchString: string): boolean 値文字列に searchString が含まれている場合は true を返します。
function endsWith(value: string, suffix: string): boolean 値文字列がサフィックスで終わる場合は true を返します。
function format(format: string, args: string[]): string 指定された書式文字列と引数を使用して、書式設定された文字列を返します。
function formatWithLocale(format: string, args: string[]): string 指定されたロケールで、指定された書式文字列と引数を使用して、書式設定された文字列を返します。
function indexOf(str: string, searchStr: string): number null を処理して、文字列内の最初のインデックスを検索します。
function indexOfFromIndex(str: string, searchStr: string, fromIndex: number): number null を処理して、指定されたインデックスから始まる文字列内の最初のインデックスを検索します。
function isAlphanumeric(str: string): boolean 文字列が英数字であるかどうかを確認します。
function isBlank(str: string): boolean 文字列が空 ("")、null、または空白のみであるかどうかを確認します。
function isEmpty(value: string): boolean 値が null または長さがゼロの文字列の場合は true を返します。
function isNumeric(str: string): boolean 文字列に Unicode 数字のみが含まれているかどうかを確認します。
function join(delimiter: string [, substring: string]...): string 区切り文字列として区切られたすべての入力サブ文字列で構成される新しい文字列を返します。
function joinExtended(delimiter: string, prefix: string, suffix: string [, substring: string]...): string 区切り文字で区切られ、プレフィックスとサフィックスが付いたすべての入力サブ文字列で構成される新しい文字列を返します。
function joinList(delimiter: string, prefix: string, suffix: string, list: list): string 区切り文字で区切られ、プレフィックスとサフィックスが付いたすべてのリスト項目で構成される新しい文字列を返します。
function lastIndexOf(str: string, searchStr: string): number 指定されたサブ文字列が文字列内で最も右に現れるインデックスを返します。
function lastIndexOfFromIndex(str: string, searchStr: string, fromIndex: number): number 指定されたインデックスから逆方向に検索して、この文字列内で指定されたサブ文字列が最後に現れるインデックスを返します。
function replaceAll(value: string, pattern: string, replacement: string): string 入力値文字列内のすべてのパターン出現を置換文字列に置き換えた新しい文字列を返します。
function replaceFirst(value: string, pattern: string, replacement: string): string 入力値文字列内の最初のパターン出現を replacement に置き換えた新しい文字列を返します。
function reverse(str: string): string 文字列を反転します。
function right(value: string, index: decimal): string 値文字列から正しい文字を含む新しい文字列を返します。
function split(str: string): string[] 指定されたテキストを、空白を区切り文字として配列に分割します。
function split(str: string, separator: string): string[] 指定されたテキストを、指定された区切り文字で配列に分割します。
function startsWith(value: string, prefix: string): boolean 値文字列がプレフィックスで始まる場合は true を返します。
function substring(value: string, startIndex: decimal, endIndex: decimal): string 値文字列の文字の部分シーケンスを含む新しい文字列を返します。
function toLowerCase(value: string): string 入力値文字列のすべての文字を小文字にした新しい文字列を返します。
function toUpperCase(value: string): string 入力値文字列のすべての文字を大文字にした新しい文字列を返します。
function trim(str: string): string この文字列の両端から制御文字 (char <= 32) を削除し、null の場合は null を返します。
function valueOf(obj: Object): string Object 引数の文字列表現を返します。

capitalize

function capitalize(str: string): string
文字列の最初の文字を Character.toTitleCase(Number) に従ってタイトルケースに変更して大文字にします。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.capitalize('hello'); // "Hello"
  var result2 := s.capitalize('hello world'); // "Hello world"
  var result3 := s.capitalize(''); // ""
  var result4 := s.capitalize(null); // null
  ...
end
パラメーター
str: 入力文字列
戻り値
大文字にされた文字列
使用可能な場所:

contains

function contains(value: string, searchString: string): boolean
値文字列に searchString が含まれている場合は true を返します。
パラメーター
value: 入力文字列
searchString: 検索する入力 searchString
戻り値
値に searchString が含まれている場合は true、含まれていない場合は false。
いずれかのパラメーターが null の場合、null を返します。
使用可能な場所:

endsWith

function endsWith(value: string, suffix: string): boolean
値文字列がサフィックスで終わる場合は true を返します。
パラメーター
value: 入力文字列
prefix: 検索する入力サフィックス
戻り値
値がサフィックスで終わる場合は true、そうでない場合は false。
いずれかのパラメーターが null の場合、null を返します。
使用可能な場所:

format

function format(format: string, args: string): string
指定された書式文字列と引数を使用して、書式設定された文字列を返します。これは Locale.US を使用します。
例:
uses core.string as s;
uses core.locale as l;
procedure doSomething()
begin
  var result := s.format(l.fromString(en-US), 'Hello, %s!', 'world'); // 'Hello, world!'
  var result2 := s.format(l.fromString(en-US),'The value is %.2f', 3.14159); // 'The value is 3.14'
  var result2 := s.format(l.fromString(fr-FR),'The value is %.2f', 3.14159); // 'The value is 3.14'
  var result3 := s.format(l.fromString(en-US), null); // null
  var result4 := s.format(l.fromString(en-US), 'No arguments'); // 'No arguments'
  ...
end
パラメーター
format: 書式文字列
args: 書式文字列内の書式指定子によって参照される引数
戻り値
書式設定された文字列
使用可能な場所:

formatWithLocale

function formatWithLocale(format: string, args: string): string
指定されたロケールで、指定された書式文字列と引数を使用して、書式設定された文字列を返します。
例:
uses core.string as s;
uses core.locale as l;
procedure doSomething()
begin
  var result := s.formatWithLocale(l.fromString(en-US), 'Hello, %s!', 'world'); // 'Hello, world!'
  var result2 := s.formatWithLocale(l.fromString(en-US),'The value is %.2f', 3.14159); // 'The value is 3.14'
  var result2 := s.formatWithLocale(l.fromString(fr-FR),'The value is %.2f', 3.14159); // 'The value is 3.14'
  var result3 := s.formatWithLocale(l.fromString(en-US), null); // null
  var result4 := s.formatWithLocale(l.fromString(en-US), 'No arguments'); // 'No arguments'
  ...
end
パラメーター
local: 書式設定に使用されるロケール
format: 書式文字列
args: 書式文字列内の書式指定子によって参照される引数
戻り値
書式設定された文字列
使用可能な場所:

indexOf

function indexOf(str: string, searchStr: string): number
null を処理して、文字列内の最初のインデックスを検索します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.indexOf('hello', 'e'); // 1
  var result2 := s.indexOf('hello', 'z'); // -1
  var result3 := s.indexOf(null, 'e'); // -1
  ...
end
パラメーター
str: 入力文字列
searchStr: 検索するサブ文字列
戻り値
文字列内でサブ文字列が最初に現れるインデックス。見つからない場合は -1
使用可能な場所:

indexOfFromIndex

function indexOfFromIndex(str: string, searchStr: string, fromIndex: number): number
null を処理して、指定されたインデックスから始まる文字列内の最初のインデックスを検索します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.indexOfFromIndex('hello', 'e', 0); // 1
  var result2 := s.indexOfFromIndex('hello', 'z', 0); // -1
  var result3 := s.indexOfFromIndex(null, 'e', 0); // -1
  ...
end
パラメーター
str: 入力文字列
searchStr: 検索するサブ文字列
fromIndex: 検索を開始するインデックス
戻り値
文字列内でサブ文字列が最初に現れるインデックス。見つからない場合は -1
使用可能な場所:

isAlphanumeric

function isAlphanumeric(str: string): boolean
文字列が英数字であるかどうかを確認します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.isAlphanumeric("hello123"); // true
  var result2 := s.isAlphanumeric("123"); // true
  var result3 := s.isAlphanumeric("hello"); // true
  var result4 := s.isAlphanumeric(null); // false
  ...
end
パラメーター
str: 入力文字列
戻り値
文字列が英数字の場合は true、それ以外の場合は false
使用可能な場所:

isBlank

function isBlank(str: string): boolean
文字列が空 ("")、null、または空白のみであるかどうかを確認します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.isBlank(''); // true
  var result2 := s.isBlank('   '); // true
  var result3 := s.isBlank(null); // true
  var result4 := s.isBlank('abc'); // false
  ...
end
パラメーター
str: 入力文字列
戻り値
文字列が空、null、または空白のみの場合は true、それ以外の場合は false
使用可能な場所:

isEmpty

function isEmpty(value: string): boolean
値が null または長さがゼロの文字列の場合は true を返します。
パラメーター
value: 文字列値。
戻り値
値が null または長さがゼロの文字列の場合は true、それ以外の場合は false。null を返すことはありません。
使用可能な場所:

isNumeric

function isNumeric(str: string): boolean
文字列に Unicode 数字のみが含まれているかどうかを確認します。このメソッドは、正または負の先行符号を許可しないことに注意してください。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.isNumeric('12345'); // true
  var result2 := s.isNumeric('-12345'); // false
  var result3 := s.isNumeric('12.345'); // false
  var result4 := s.isNumeric(null); // false
  ...
end
パラメーター
str: 入力文字列
戻り値
文字列に Unicode 数字のみが含まれている場合は true、それ以外の場合は false
使用可能な場所:

join

function join(delimiter: string ...): string
区切り文字列として区切られたすべての入力サブ文字列で構成される新しい文字列を返します。
パラメーター
delimiter: 入力区切り文字列
substring: 結果文字列に追加するサブ文字列。すべてのエレメントは文字列にする必要があります。
戻り値
区切り文字で区切られたすべての入力サブ文字列で構成される新しい文字列。
区切り文字が null の場合は null を返します。null のサブ文字列はすべて文字列 'null' に置き換えられます。
使用可能な場所:

joinExtended

function joinExtended(delimiter: string, prefix: string, suffix: string ...): string
区切り文字で区切られ、プレフィックスとサフィックスが付いたすべての入力サブ文字列で構成される新しい文字列を返します。
パラメーター
delimiter: 入力区切り文字列。
prefix: 入力プレフィックス文字列。
suffix: 入力サフィックス文字列。
substring: 結果文字列に追加するサブ文字列。すべてのエレメントは文字列にする必要があります。
戻り値
区切り文字で区切られたすべての入力サブ文字列で構成される新しい文字列。
区切り文字、プレフィックス、またはサフィックスが null の場合は null を返します。null のサブ文字列はすべて文字列 'null' に置き換えられます。
使用可能な場所:

joinList

function joinList(delimiter: string, prefix: string, suffix: string, list: list): string
区切り文字で区切られ、プレフィックスとサフィックスが付いたすべてのリスト項目で構成される新しい文字列を返します。
パラメーター
delimiter: 入力区切り文字列。
prefix: 入力プレフィックス文字列。
suffix: 入力サフィックス文字列。
list: 結果文字列に追加する文字列のリスト。
戻り値
入力区切り文字で区切られたすべての入力サブ文字列で構成される新しい文字列。
いずれかのパラメーターが null の場合は null を返します。リストの null 項目はすべて文字列 'null' に置き換えられます。
使用可能な場所:

lastIndexOf

function lastIndexOf(str: string, searchStr: string): number
指定されたサブ文字列が文字列内で最も右に現れるインデックスを返します。最も右の空文字列 "" は、インデックス値 str.length() で現れると見なされます。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.lastIndexOf('hello', 'o'); // 4
  var result2 := s.lastIndexOf('hello', 'z'); // -1
  var result3 := s.lastIndexOf(null, 'e'); // -1
  ...
end
パラメーター
str: 入力文字列
searchStr: 検索するサブ文字列
戻り値
文字列内でサブ文字列が最後に現れるインデックス。見つからない場合は -1
使用可能な場所:

lastIndexOfFromIndex

function lastIndexOfFromIndex(str: string, searchStr: string, fromIndex: number): number
指定されたインデックスから逆方向に検索して、この文字列内で指定されたサブ文字列が最後に現れるインデックスを返します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.lastIndexOfFromIndex('hello', 'o', 3); // 4
  var result2 := s.lastIndexOfFromIndex('hello', 'o', 2); // 4
  var result3 := s.lastIndexOfFromIndex('hello', 'o', 0); // -1
  ...
end
パラメーター
str: 入力文字列
searchStr: 検索するサブ文字列
fromIndex: 検索を開始するインデックス
戻り値
文字列内でサブ文字列が最後に現れるインデックス。見つからない場合は -1
使用可能な場所:

replaceAll

function replaceAll(value: string, pattern: string, replacement: string): string
入力値文字列内のすべてのパターン出現を置換文字列に置き換えた新しい文字列を返します。
パラメーター
value: 入力文字列
pattern: 置き換える文字列パターン (正規表現)
replacement: 置換文字列
戻り値
新しい文字列。パラメーターが null の場合は null。
使用可能な場所:

replaceFirst

function replaceFirst(value: string, pattern: string, replacement: string): string
入力値文字列内の最初のパターン出現を replacement に置き換えた新しい文字列を返します。
パラメーター
value: 入力文字列
pattern: 置き換える文字列パターン (正規表現)
replacement: 置換文字列
戻り値
新しい文字列。いずれかのパラメーターが null の場合は null。
使用可能な場所:

reverse

function reverse(str: string): string
文字列を反転します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.reverse('hello'); // "olleh"
  var result2 := s.reverse(''); // ''
  var result3 := s.reverse(null); // null
  ...
end
パラメーター
str: 入力文字列
戻り値
反転された文字列
使用可能な場所:
function right(value: string, index: decimal): string
値文字列から正しい文字を含む新しい文字列を返します。
指定されたインデックスから始まり、文字列の終わりまで続きます。
パラメーター
value: 入力文字列
index: 入力開始インデックス (含む)。0以上、文字列の長さ以下の整数にする必要があります。
戻り値
新しい文字列。いずれかのパラメーターが null の場合は null。
使用可能な場所:

split

function split(str: string): string
指定されたテキストを、空白を区切り文字として配列に分割します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.split('hello world'); // ['hello', 'world']
  var result2 := s.split(''); // ['']
  var result3 := s.split(null); // null
  ...
end
パラメーター
str: 入力文字列
戻り値
サブ文字列の配列
使用可能な場所:

splitWith

function split(str: string, separator: string): string
指定されたテキストを、指定された区切り文字で配列に分割します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.split('hello,world', ','); // ['hello', 'world']
  var result2 := s.split('hello world', ' '); // ['hello', 'world']
  var result3 := s.split('', ' '); // ['']
  var result4 := s.split(null, ' '); // null
  ...
end
パラメーター
str: 入力文字列
separator: 区切り文字列
戻り値
サブ文字列の配列
使用可能な場所:

startsWith

function startsWith(value: string, prefix: string): boolean
値文字列がプレフィックスで始まる場合は true を返します。
パラメーター
value: 入力文字列
prefix: 検索する入力プレフィックス
戻り値
値がプレフィックスで始まる場合は true、そうでない場合は false。
いずれかのパラメーターが null の場合、null を返します。
使用可能な場所:

substring

function substring(value: string, startIndex: decimal, endIndex: decimal): string
値文字列の文字の部分シーケンスを含む新しい文字列を返します。
サブ文字列は、指定された startIndex から始まり、入力文字列の endIndex まで拡張されます。
パラメーター
value: 入力文字列
startIndex: 入力開始インデックス (含む)。0 以上、文字列の長さ以下の整数にする必要があります。
endIndex: 入力終了インデックス (含まない)。startIndex 以上、文字列の長さ以下の整数にする必要があります。
戻り値
新しい文字列。いずれかのパラメーターが null の場合は null。
使用可能な場所:

toLowerCase

function toLowerCase(value: string): string
入力値文字列のすべての文字を小文字にした新しい文字列を返します。
パラメーター
value: 入力文字列
戻り値
小文字の文字列。パラメーターが null の場合は null。
使用可能な場所:

toUpperCase

function toUpperCase(value: string): string
入力値文字列のすべての文字を大文字にした新しい文字列を返します。
パラメーター
value: 入力文字列
戻り値
大文字の文字列。パラメーターが null の場合は null。
使用可能な場所:

trim

function trim(str: string): string
この文字列の両端から制御文字 (char <= 32) を削除し、null の場合は null を返します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.trim('  hello  '); // "hello"
  var result2 := s.trim('   '); // ""
  var result3 := s.trim(null); // null
  ...
end
パラメーター
str: 入力文字列
戻り値
トリムされた文字列
使用可能な場所:

valueOf

function valueOf(obj: Object): string
Object 引数の文字列表現を返します。
例:
uses core.string as s;
procedure doSomething()
begin
  var result := s.valueOf('hello'); // 'hello'
  var result2 := s.valueOf(123); // '123'
  var result3 := s.valueOf(null); // null
  ...
end
パラメーター
obj: 文字列に変換するオブジェクト
戻り値
オブジェクトの文字列表現
使用可能な場所: