System.Classes.TListSortCompare

提供:RAD Studio API Documentation

Delphi

TListSortCompare = function (Item1, Item2: Pointer): Integer;

C++

typedef int __fastcall (*TListSortCompare)(void * Item1, void * Item2);

プロパティ

種類 可視性 ソース ユニット 親
type
typedef
public
System.Classes.pas
System.Classes.hpp
System.Classes System.Classes

説明

TListSortCompare は、TList クラスによって内部的に使用されるコールバック関数の型です。

TList クラスの Sort メソッドを使う必要がある場合に、TListSortCompare 関数を定義します。 この関数は、TList の要素をソートするために、Sort メソッドの内部実装によって呼び出されます。 このようなユーザー提供型のソート処理が必要になるのは、TList が、固有のソート順を持たないポインタのリストだからです。

Item1 と Item2 がリストの要素だとします。これらが TListSortCompare 関数に渡されると、Sort メソッドはそれらの順番を問い合わせます。この比較によって、Item1 と Item2 の相対値から決定された値が返ります。以下の表にその値を示します。



値 説明

>0 (正)

Item1 は Item2 より大きい。

0

Item1 は Item2 に等しい。

<0 (負)

Item1 は Item2 より小さい。



関連項目