ユニット core.list
リストを作成および更新するためのメソッドを提供するスクリプトユニットです。
add
procedure add(values: list<ItemType>, element: ItemType)
値リストにエレメントを追加します。
パラメーター
values:入力リスト
element:追加する入力エレメント。そのタイプは、リストのタイプと互換性がある必要があります。
addAll
procedure addAll(values: list<ItemType>, elements: list<ItemType>): boolean
すべてのエレメントを値リストに追加します。
パラメーター
values:入力リスト
elements:追加するエレメント。エレメントタイプは、リストのタイプと互換性がある必要があります。
戻り値
この呼び出しによって値リストの内容が変更された場合は true、そうでない場合は false
addFirst
procedure addFirst(list: list<ItemType>, element: ItemType)
指定されたエレメントをリストの先頭に追加します。
例:
uses core.list as l;
procedure doSomething()
begin
var list := ["apple", "banana", "orange"];
l.addFirst(list, "pear"); // ["pear", "apple", "banana", "orange"]
...
end
パラメーター
list:更新するリスト
element:リストの先頭に追加するエレメント
clear
procedure clear(list: list)
リストからすべてのエレメントを削除します。
パラメーター
list:クリアするリスト
clone
function clone(list: list): list
リストのシャロークローンを返します。
パラメーター
list:クローンするリスト
戻り値
入力リストと同じエレメントを持つ新しいリスト
contains
function contains(values: list<ItemType>, element: ItemType): boolean
値リストにエレメントが含まれている場合は true を返します。
パラメーター
values:入力リスト。内容はエレメントと同じ種類にする必要があります
element:検索する入力エレメント。値の内容と同じ種類にする必要があります
戻り値
値にエレメントが含まれている場合は true、含まれていない場合は false
値が null の場合、null を返します
containsAll
function containsAll(values: list<ItemType>, element: ItemType): boolean
値リストにすべてのエレメントが含まれている場合は true を返します。
パラメーター
values:入力リスト。内容はエレメントと同じ種類にする必要があります
elements:検索する入力エレメント。値と同じ種類にする必要があります
戻り値
値にすべてのエレメントが含まれている場合は true、それ以外の場合は false
いずれかのパラメーターが null の場合、null を返します
indexOf
function indexOf(values: list<ItemType>, element: ItemType)
値リスト内のエレメントの最初の出現のインデックスを返します。
パラメーター
values:入力リスト
element:検索する入力エレメント。そのタイプは、リストのタイプと互換性がある必要があります
戻り値
値リスト内のエレメントの最初のオカレンスのインデックス。見つからない場合は null
isEmpty
function isEmpty(value: list<ItemType>): boolean
値が null またはサイズがゼロのリストの場合は true を返します。
パラメーター
values:入力リスト
戻り値
値が null またはサイズがゼロのリストの場合は true、それ以外の場合は false。null を返すことはありません
lastIndexOf
function lastIndexOf(values: list<ItemType>, element: ItemType)
値リスト内のエレメントの最後の出現のインデックスを返します。
パラメーター
values:入力リスト
element:検索する入力エレメント
戻り値
値リスト内のエレメントの最後のオカレンスのインデックス。見つからない場合は null
of
パラメーターとして渡されたエレメントを使用してリストを作成します。すべてのエレメントは同じタイプにする必要があります。
例:
uses core.list as list;
function getCities(): list<string>
begin
return list.of('Paris', 'Bruxelles', 'Berlin');
end
関数の型
ItemType:返されたリストのアイテムのタイプ。少なくとも 1 つの値が指定されている場合はオプションです
パラメーター
value: リストに追加するアイテム。すべてのアイテムは同じタイプにする必要があります
戻り値
新しいリスト。更新可能です
remove
function remove(values: list<ItemType>, element: ItemType): boolean
値リストからエレメントの最初の出現を削除します。
パラメーター
values:入力リスト
element:追加する入力エレメント。そのタイプは、リストのタイプと互換性がある必要があります
戻り値
値リストの内容がこの呼び出しによって変更された場合は true、そうでない場合は false
removeAll
function removeAll(values: list<ItemType>, elements: list<ItemType>): boolean
値リストからすべてのエレメントを削除します。
パラメーター
values:入力リスト
elements:削除するエレメント。エレメントタイプは、リストのタイプと互換性がある必要があります
戻り値
値リストの内容がこの呼び出しによって変更された場合は true、そうでない場合は false
retainAll
function retainAll(values: list<ItemType>, elements: list<ItemType>): boolean
値リスト内のエレメントのうち、エレメントに含まれるエレメントのみを保持します。つまり、値リストから、エレメントに含まれないすべてのエレメントを削除します。
パラメーター
values:入力リスト
elements:保持するエレメント。エレメントタイプは、リストのタイプと互換性がある必要があります
戻り値
値リストの内容がこの呼び出しによって変更された場合は true、そうでない場合は false
reverse
procedure reverse(values: list<ItemType>)
値内のエレメントの順序を逆にします。値が null またはサイズがゼロのリストの場合は何も実行されません。
パラメーター
values:反転する入力リスト
reverseSort
procedure reverseSort(values: list<ItemType>)
指定された値のリストを、そのエレメントの自然な順序に従って降順に並べ替えます。値が null またはサイズがゼロのリストの場合は何も実行されません。
パラメーター
values:並べ替える入力リスト
sort
procedure sort(values: list<ItemType>)
指定された値のリストを、そのエレメントの自然な順序に従って昇順に並べ替えます。値が null またはサイズがゼロのリストの場合は何も実行されません。
パラメーター
values:並べ替える入力リスト
subList
function subList<ItemType>(values: list<ItemType>, startIndex: decimal, endIndex: decimal): list<ItemType>
値リストのエレメントのサブシーケンスを含む新しいリストを返します。
subListは、指定された startIndex から始まり、入力リストの endIndex まで拡張されます。
関数の型
ItemType:返されたリストのアイテムのタイプ。オプションです
パラメーター
values:入力リスト
startIndex: 入力開始インデックス。正の整数またはゼロにする必要があります
endIndex:入力終了インデックス。正の整数またはゼロにする必要があります
戻り値
新しいリスト。パラメーターが null の場合は null