アイテムのインデックス取得 (GetIndexOfItem)
概要 (What is it?)
GetIndexOfItem ノードは、リスト内における特定のアイテムの位置(インデックス番号)を検索するユーティリティノードです。リスト内でアイテムが最初に出現した位置のインデックス(0始まり)を返します。
使用する場面 (When would I use it?)
以下のような場面で GetIndexOfItem ノードを使用します:
- リスト内でのアイテムの位置を特定したい場合
- コレクション内の特定のアイテムを見つけ出したい場合
- 位置(インデックス)によってアイテムを参照する必要があるワークフローを構築したい場合
- リスト内のアイテムの位置関係を検証したい場合
- 動的リスト内でのアイテムの現在位置を追跡したい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに GetIndexOfItem ノードを追加します
- 検索対象のリストを "items" 入力に接続します
- 探したいアイテムを "item" 入力に接続します
- ノードがリスト内でのアイテムのインデックス番号を出力します
パラメータ一覧 (Parameters)
- items: 検索対象のリスト(リスト入力)
- item: リスト内で検索するアイテム(任意の型)
- index: リスト内でのアイテムの位置(整数出力)
出力 (Outputs)
- index: アイテムの位置を表す整数値(見つからない場合は
-1)
使用例 (Example)
タスクリスト内で特定のタスクが何番目にあるかを調べたい場合の例:
- ワークフローに GetIndexOfItem ノードを追加します
- タスクリストを "items" 入力に接続します
- 探したいタスクを "item" 入力に接続します
- "index" 出力に、そのタスクのリスト内でのインデックス番号が表示されます
重要な注意点 (Important Notes)
- アイテムがリスト内に存在しない場合、ノードは
-1を返します - インデックスは
0から始まります(最初のアイテムはインデックス 0) - 同じアイテムが複数存在する場合、最初に見つかった位置のインデックスを返します
- リストまたは検索アイテムのいずれかが変更されると、出力は自動的に再計算されます
よくある問題 (Common Issues)
- アイテムが見つからない: アイテムがリスト内にない場合、出力は
-1になります - 入力がない: リストまたは検索アイテムのいずれかが未接続の場合、出力は
-1になります - 無効な入力: 入力がリスト型でない場合、出力は
-1になります - 型の不一致: 適切な比較を行うために、検索アイテムの型とリスト内アイテムの型が一致している必要があります
- 大文字・小文字の区別: 文字列の比較は大文字と小文字を厳密に区別します