GetArrayElement_OrNil
Basic| モジュール: | FoundationLite |
|---|
指定されたインデックスにある配列から１つの要素を抽出します。インデックスが範囲外の場合は NIL を返します。
| 名前 | 型 | 範囲 | 説明 | |
|---|---|---|---|---|
 |
inArray | <T>Array | 入力配列 | |
|
inIndex | Integer | 0 -  |
配列内のインデックス |
|
inInverse | Bool | インデックスを入力配列の先頭から数えるか、末尾から数えるかを指定します | |
 |
outConditionalValue | <T>? | 配列からの要素 | |
このフィルターの型は、任意の有効な型を表す型変数 T を使用して定義されています。 詳しくはこちら.
ヒント
- inIndex が常に範囲内であることが保証できる場合は、代わりに GetArrayElement を使用してください。
- 配列の最後の要素を取得するには、inIndex = 0、かつ inInverse = True を使用してください。
使用例
|
|
|
inArray = {1, 4, 3, 2, 5} inIndex = 3 |
outValue = 2 |
|
|
|
inArray = {1, 4, 3, 2, 5} inIndex = 5 |
outValue = Nil |
エラー
このフィルターは、問題が発生した場合に例外としてエラーを通知することがあります。エラーへの対処方法については、エラーハンドリングをご覧ください。
発生する可能性のある例外の一覧：
| エラータイプ | 説明 |
|---|---|
| DomainError | GetArrayElement_OrNil において、インデックスが負の値です。 |
複雑さのレベル
このフィルタは Basicレベルで使用できます。
フィルターグループ
このフィルターは、GetArrayElement フィルターグループに属しています。
関連項目
- SetArrayElement – 配列の要素に新しい値を設定します。