プリミティブプロパティとは、特定の型の値向けに用意された特殊な値あるいは関数です。
オブジェクトのプロパティのように.<name>
の記法で呼び出すことができます。([<str>]
の記法は使えません)
// 例
'ai kawaii'.len //9
Core:range(0,2).push(4) //[0,1,2,4]
今の所、数値・文字列・配列・エラー型に対応するものが用意されています。オブジェクトのそれに相当するものは、記法との兼ね合いでstd関数として実装されています。
本ページでは、(型名)型の任意の値に対するプリミティブプロパティを下記のような形式で表記します。
#(v: 型名).プロパティ名
// または
@(v: 型名).プリミティブ関数名(引数リスト): 返り値の型
#から始まるものは関数以外の値を持つプリミティブプロパティです。 @から始まるものは関数のプリミティブプロパティ(プリミティブ関数)です。
数値を文字列に変換します。
型: num
文字列の長さを取得します。
文字列が数字であれば、数値に変換します。
文字列を書記素クラスタ毎に区切り、配列にしたものを返します。
文字列に孤立サロゲートが含まれない場合、孤立サロゲートを返すことはありません。
文字列を Unicode コードポイント毎に区切り、配列にしたものを返します。
書記素クラスタは分割されます。
文字列に孤立サロゲートが含まれない場合、孤立サロゲートを返すことはありません。
文字列を Unicode コードポイント毎に区切り、それぞれコードポイント値を取得し配列にしたものを返します。
文字列に孤立サロゲートが含まれない場合、孤立サロゲートを返すことはありません。
文字列を UTF-16 コード単位毎に区切り、配列にしたものを返します。
文字列にサロゲートペアが含まれる場合、上位と下位それぞれ孤立サロゲートを返します。
文字列を UTF-16 コード単位毎に区切り、それぞれUTF-16 コード単位を表す 0
から 65535
までの整数を取得し配列にしたものを返します。
文字列にサロゲートペアが含まれる場合、上位と下位それぞれ孤立サロゲートを返します。
文字列を UTF-8 エンコードし、各バイト毎の 0
から 255
までの整数値を取得し配列にしたものを返します。
文字列中の i 番目の文字を取得します。
文字列中に keyword が含まれていればtrue
、なければfalse
を返します。
文字列の begin 番目から end 番目の直前までの部分を取得します。
文字列を splitter がある場所で区切り、配列にしたものを返します。
splitter が与えられなければ一文字づつ区切ります。
文字列中の old を new に置換したものを返します。
文字列中から_search_を探し、その添字を返します。
_fromIndex_が指定されていれば、その位置から検索を開始します。
_fromIndex_が負値の時は末尾からの位置(文字列の長さ+fromIndex)が使用されます。
該当が無ければ-1を返します。
文字列の長さがが width になるように、先頭を pad の繰り返しで埋めた新しい文字列を返します。
pad を省略した場合、空白' '
で埋められます。
pad が長すぎる場合、pad の末尾が切り捨てられます。
文字列の長さがが width になるように、末尾を pad の繰り返しで埋めた新しい文字列を返します。
pad を省略した場合、空白' '
で埋められます。
pad が長すぎる場合、pad の末尾が切り捨てられます。
文字列の前後の空白を取り除いたものを返します。
文字列中の英字を大文字に変換して返します。
文字列中の英字を小文字に変換して返します。
i 番目のにある UTF-16 コード単位を表す 0
から 65535
までの整数を返します。
インデックスは UTF-16 コード単位に基づきます。
文字列にサロゲートペアが含まれる場合、位置によって上位または下位の孤立サロゲートを返すことがあります。
i 番目の文字が存在しない場合は null が返されます。
i 番目の文字のコードポイントを取得します。
インデックスは UTF-16 コード単位に基づきます。
文字列にサロゲートペアが含まれ、指定位置が下位のサロゲートである場合、下位の孤立サロゲートを返します。
i 番目の文字が存在しない場合は null が返されます。
型: num
配列の要素数を取得します。
【この操作は配列を書き換えます】
配列の最後に要素を追加します。
【この操作は配列を書き換えます】
配列の最初に要素を追加します。
【この操作は配列を書き換えます】
配列の最後の要素を取り出します。
【この操作は配列を書き換えます】
配列の最初の要素を取り出します。
配列を連結します。
文字列の配列を結合して一つの文字列として返します。
配列の begin 番目から end 番目の部分を切り出して返します。
配列に指定した値が含まれているかどうかを返します。
配列の各要素に対し func を非同期的に呼び出します。 それぞれの要素を func の返り値で置き換えたものを返します。
配列の要素のうち func が true を返すようなもののみを抜き出して返します。
順序は維持されます。
配列の各要素に対し func を順番に呼び出します。
各呼び出しでは、前回の結果が第1引数 acm として渡されます。
initial が指定された場合は初回呼び出しの引数が(initial, v[0], 0)、
指定されなかった場合は(v[0], v[1], 1)となります。
配列から func が true を返すような要素を探し、その値を返します。
配列から_val_と同じ値を探し、その添字を返します。
_fromIndex_が指定されていれば、その位置から検索を開始します。
_fromIndex_が負値の時は末尾からの位置(配列の長さ+fromIndex)が使用されます。
該当が無ければ-1を返します。
【この操作は配列を書き換えます】
配列を反転させます。
配列のコピーを生成します。
シャローコピーであり、配列やオブジェクトの参照は維持されます。
【この操作は配列を書き換えます】
配列の並べ替えをします。第1引数 comp として次のような比較関数を渡します。
- a が b より順番的に前の時、負の値を返す
- a が b より順番的に後の時、正の値を返す
- a が b と順番的に同等の時、0を返す
数値の並び替えではCore:sub
を渡すことで昇順、@(a,b){b-a}
を渡すことで降順ソートができます。
文字列用の比較関数としてStr:lt
(昇順), Str:gt
(降順)が用意されています。詳しくはstd.mdをご覧下さい。
【この操作は配列を書き換えます】
配列の fromIndex から toIndex までの範囲の要素を val で置き換えます。
val 省略時はnull
で置き換えます。
fromIndex および toIndex に関する挙動はarr.slice
に準拠します。
配列を times 回繰り返した配列を作成します。
arr.copy
同様シャローコピーであり、配列やオブジェクトの参照は維持されます。
times には0以上の整数値を指定します。それ以外ではエラーになります。
配列の全ての要素に対して func が true を返す時のみ true 返します。空配列には常に true を返します。
配列の要素に対して func が true を返す要素が存在する時のみ true 返します。
型: str
エラーの識別子となる文字列を取得します。
型: value
エラーに付加情報がある場合、それを取得します。