ユニット core.string
文字列操作機能を提供するスクリプトユニット。
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
指定された書式文字列と引数を使用して、書式設定された文字列を返します。これは 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
指定されたロケールで、指定された書式文字列と引数を使用して、書式設定された文字列を返します。
例:
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
区切り文字列として区切られたすべての入力サブ文字列で構成される新しい文字列を返します。
パラメーター
delimiter: 入力区切り文字列
substring: 結果文字列に追加するサブ文字列。すべてのエレメントは文字列にする必要があります。
戻り値
区切り文字で区切られたすべての入力サブ文字列で構成される新しい文字列。
区切り文字が null の場合は null を返します。null のサブ文字列はすべて文字列 'null' に置き換えられます。
使用可能な場所:
joinExtended
区切り文字で区切られ、プレフィックスとサフィックスが付いたすべての入力サブ文字列で構成される新しい文字列を返します。
パラメーター
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: 入力文字列
戻り値
反転された文字列
使用可能な場所:
right
function right(value: string, index: decimal): string
値文字列から正しい文字を含む新しい文字列を返します。
指定されたインデックスから始まり、文字列の終わりまで続きます。
パラメーター
value: 入力文字列
index: 入力開始インデックス (含む)。0以上、文字列の長さ以下の整数にする必要があります。
戻り値
新しい文字列。いずれかのパラメーターが null の場合は null。
使用可能な場所:
split
指定されたテキストを、空白を区切り文字として配列に分割します。
例:
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
指定されたテキストを、指定された区切り文字で配列に分割します。
例:
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: 文字列に変換するオブジェクト
戻り値
オブジェクトの文字列表現
使用可能な場所: