min()

配列の中のビジネス・オブジェクトのうち、指定した属性の最小値を検索します。

構文

String min(String attr)
 

パラメーター

attr
ビジネス・オブジェクト内の属性を参照する String 型LongText 型Integer 型Float 型、または Double 型の変数。

戻り値

指定した属性の、ストリング形式での最小値。または、BusObjArray 内のすべてのエレメントについてその属性の値が null である場合は null。

例外

UnknownAttributeException - 指定した属性が、渡されたビジネス・オブジェクトの有効な属性ではない場合です。

UnsupportedAttributeTypeException - 指定した属性のデータ型が、『注記』セクションにあるサポート対象の属性データ型ではない場合です。

上記の例外すべては CollaborationException からサブクラス化されています。min() メソッドは、これらの例外に対して例外タイプ AttributeException を設定できます。

注記

min() メソッドは、ビジネス・オブジェクト配列の中のビジネス・オブジェクトのうち、指定した属性の最小値を検索します。

例えば、Employee ビジネス・オブジェクトを含むビジネス・オブジェクト配列があり、入力引き数が Float 型の属性 Salary であるとします。このメソッドは、すべての Employee ビジネス・オブジェクトの中で Salary の最小値を調べ、その値を含むビジネス・オブジェクトを戻します。Salary の最小値を持つビジネス・オブジェクトが複数ある場合は、それらのビジネス・オブジェクトすべてが戻されます。

指定した属性が null を含むビジネス・オブジェクトは無視されます。配列内のすべてのビジネス・オブジェクトで値が null である場合、null が戻されます。

属性のデータ型が String のときは、字句が最短のストリングが戻されます。

String minSalary = items.min("Salary");
 

Copyright IBM Corp. 2004