コンテンツにスキップ

リスト長取得 (GetListLength)

概要 (What is it?)

GetListLength ノードは、リスト内のアイテム数を計算して出力するユーティリティノードです。ワークフロー内の任意のリストのサイズ(要素数)を取得するシンプルな手段を提供します。

使用する場面 (When would I use it?)

以下のような場面で GetListLength ノードを使用します:

  • リストにいくつのアイテムが含まれているか知りたい場合
  • リストが空であるか、または特定の要素数を持っているかを確認したい場合
  • リストのサイズに依存するワークフローを構築したい場合
  • 後続処理を実行する前にリストの長さを検証したい場合
  • 動的リストの要素数の変化を監視したい場合

使い方 (How to use it)

基本セットアップ

  1. ワークフローに GetListLength ノードを追加します
  2. 任意のリストを "items" 入力に接続します
  3. ノードがリストの長さを自動計算して出力します

パラメータ一覧 (Parameters)

  • items: 要素数を測定する対象のリスト(リスト入力)
  • length: リスト内のアイテム数(整数出力)

出力 (Outputs)

  • length: 入力リストのアイテム数を表す整数値

使用例 (Example)

タスクリストにいくつのタスクが含まれているかを確認したい場合の例:

  1. ワークフローに GetListLength ノードを追加します
  2. タスクリストを "items" 入力に接続します
  3. "length" 出力に、リスト内のタスクの合計数が表示されます

重要な注意点 (Important Notes)

  • 入力リストが変更されると、長さは自動的に再計算されます
  • 入力リストが空であるか未指定の場合、長さは 0 になります
  • 出力される長さは常に 0 以上の整数です
  • あらゆる型のアイテムを含むリストに対して動作します

よくある問題 (Common Issues)

  • 空のリスト: リストが接続されていない場合、長さは 0 になります
  • 無効な入力: 入力がリスト型でない場合、長さは 0 になります
  • 型の不一致: リスト型以外の入力が渡された場合、結果は 0 になります