Copyright 1999 Rogue Wave Software
Copyright 1999 Sun Microsystems, Inc.

クラスの概要

1

Tools.h++ が提供するのは、方針ではなく実装です。したがって、Tools.h++ の大部分は、大規模で充実した具体クラスのセットです。これらのクラスは、自身の実装や意味に関しては他のクラスに依存せず、独立して使用できるようになっています。このため、一度に 1、2 個だけ抜き出して使用できます。具体クラスは Tools.h++ のもっとも重要な部分です。

また、Tools.h++ には、充実した抽象基底クラスのセットも入っています。抽象クラスは、持続性や国際化、その他の問題に対するインタフェースを定義しています。さらに、これらのインタフェースを実装する多数の実装クラスも入っています。実装クラスは公開ですが、非公開クラスと同様に機能します。実装クラスは、使用を目的として設計されていないため、ここでは説明しません。

Tools.h++ クラスの中には、コレクションクラス (あるいはコレクション) としてさらに分類されるものがあります。Tools.h++ の中心的な機能であるコレクションクラスは、次の 3 つのグループに分類されます。

• テンプレートにもとづくコレクションクラス。短縮して、コレクションクラステンプレート、または単にテンプレートとも呼ばれます。
• 総称コレクションクラス
• Smalltalk 式コレクションクラス

プログラムで使用するコレクションクラスの選択は、非常に難しい仕事です。このマニュアルでは、各自の目的に最適のクラスを判断する際に役立つ、「コレクションの選択」という付録を付けてあります。

この章の最後にある表 1-2 には、Tools.h++ の全公開クラスのクラス階層を示しています。これらの公開クラスだけでなく、Tools.h++ には、その内部使用のためのクラスも含まれています。

• 日付、時刻、文字列などを表わす単純クラス。第 3 〜 5 章で説明します。
• テンプレートにもとづくコレクションクラス。第 10 章「コレクションクラステンプレート」で説明します。
• プリプロセッサの <generic.h> 機能を使用する総称コレクションクラス。第 11 章「総称コレクションクラス」で説明します。

テンプレートにもとづくコレクションクラス

総称コレクションクラス

持続性

RWFile&      operator<<(RWFile& file, const ClassName&);
RWFile&      operator>>(RWFile& file,       ClassName&);
Rwvostream&  operator<<(RWvostream& vstream,const ClassName&);
Rwvistream&  operator>>(RWvistream& vstream,  ClassName&);

クラス RWvistream と RWvostream は、RogueWave の仮想ストリーム機能で使用される抽象基底クラスです。最終的な出力形式は特殊化クラスによって決定されます。たとえば、RWpistream と RWpostream は、それぞれ RWvistream と RWvostream から派生するクラスですが、これらは "可搬性がある ASCII 形式" を使用してオブジェクトを格納したり取り出すことができます。この結果、異なるオペレーティングシステムの間で転送することができます。これらのクラスについては、第 5 章「仮想ストリーム」および『Tools.h++ 7.0 クラスライブラリ・リファレンスマニュアル』で詳しく説明します。

RWFiles と Rogue Wave ストリームのどちらに格納するかは、ユーザーが決定することです。RWFiles に格納する場合、速度の点では優れていますが、その結果の可搬性がホストのマシンとオペレーティングシステムに制限されます。Rogue Wave ストリームに格納する場合、速度の点では劣っていますが、いくつかの特殊化クラスを得ることができます。これらのクラスは、異なるマシン間で可搬性の高い形式、分散計算のための XDR ストリームカプセル化などの便利な機能を提供します。

記憶サイズ

    Rwspace  ClassName::binaryStoreSize() const;
    Rwspace  ClassName::recursiveStoreSize() const;

    RWFile& operator<<(RWFile& file, const ClassName&);

    RWFile& operator<<(RWFile& file, const RWCollectable&)

ストリーム入出力

    ostream&  operator<<(ostream& ostr, const ClassName& x);
    istream&  operator>>(istream& istr, const ClassName& x);

Rwvostream&  operator<<(RWvostream& vstream, const ClassName&);
Rwvistream&  operator>>(RWvistream& vstream,       ClassName&);

比較

int        compareTo(ClassName*) const;
RWBoolean  equalTo(ClassName*) const;

RWBoolean  operator==(const ClassName&) const;
RWBoolean  operator!=(const ClassName&) const;
RWBoolean  operator<=(const ClassName&) const;
RWBoolean  operator>=(const ClassName&) const;
RWBoolean  operator<(const ClassName&) const;
RWBoolean  operator>(const ClassName&) const;

Rouge Wave クラスのほとんどは、非常に単純な方法をとります。ユーザーが何かにヒープ領域を割り当てた場合、それを開放するのはユーザーの責任になります。Rogue Wave ライブラリが何かにヒープ領域を割り当てた場合、それを開放するのは Rogue Wave ライブラリの責任になります。

オブジェクトの作成には 2 つの例外があります。最初の例外は次の演算子です。

RWFile&      operator>>(RWFile& file, RWCollectable*&);
Rwvistream&  operator>>(RWvistream& vstream, RWCollectable*&);

第 2 の例外は次のメンバー関数です。

RWCollection* RWCollection::select(RWtestCollectable,   void*)const;

オブジェクト削除の例外もあります。サービスとして、コレクションクラスの多くはメソッド clearAndDestroy() を提供します。これは、コレクションからすべてのポインタを取り除いて、それぞれを削除します。ただし、clearAndDestroy() を使用する場合でも、コレクション内のポインタすべてを削除しても安全かどうかを確認するのはユーザーの責任です。

これらのメソッドの詳細は、『Tools.h++ 7.0 クラスライブラリ・リファレンスマニュアル』に記載されています。

    void  foo(const RWCString& a)

引数がポインタとして渡される場合は、関数がそのポインタのコピーを保持する可能性が高くなります。これは、コレクションクラスの特徴を示すものです。

    RWOrdered::insert(RWCollectable*);

無効なインデックスは <rw/defs.h> 内で定義された特別な値 RW_NPOS によって決まります。

実行時にバージョン番号が必要である場合は、ヘッダファイル <rw/tooldefs.h> に宣言された関数 rwToolsVersion() を使用して調べることができます。

RWBench
RWBitVec
RWBTreeOnDisk
RWCacheManager
RWCollectable
       RWCollection
                RWBag
                RWBinaryTree
                RWBTree
                       RWBTreeDictionary
                RWHashTable
                       RWSet
                            RWFactory
                              RWHashDictionary
                                     RWIdentityDictionary
                              RWIdentitySet
                RWSequenceable
                       RWDlistCollectables
                       RWOrdered
                              RWSortedVector
                       RWSlistCollectables
                              RWSlistCollectablesQueue
                              RWSlistCollectablesStack
       RWCollectableDate (&RWDate)
       RWCollectableInt (&RWInteger)
       RWCollectableString (&RWCString)
       RWCollectableTime (&RWTime)
       RWModelClient
RWCRegexp
RWCRExp
RWCString
       RWCollectableString (&RWCollectable)
RWCSubString
RWCTokenizer
RWDate
       RWCollectableDate (&RWCollectable)
RWErrObject
RWFile
       RWFileManager
RWGBitVec(size)
RWGDlist(type)
RWGDlistIterator(type)
RWGOrderedVector(val)
RWGQueue(type)
RWGSlist(type)
RWGSlistIterator(type)
RWGStack(type)
RWGVector(val)
       RWGSortedVector(val)
RWInteger
       RWCollectableInt (&RWCollectable)
RWIterator
       RWBagIterator
       RWBinaryTreeIterator
       RWDlistCollectablesIterator
       RWHashDictionaryIterator
       RWHashTableIterator
                RWSetIterator
       RWOrderedIterator
       RWSlistCollectablesIterator
RWLocale
       RWLocaleSnapshot
RWMessage
RWModel
RWTime
       RWCollectableTime (&RWCollectable)
RWTimer
RWTBitVec<size>
RWTIsvDlist<T>
RWTIsvDlistIterator<TL>
RWTIsvSlist<T>
RWTIsvSlistIterator<TL> 
RWTPtrDeque<T>
RWTPtrDlist<T>
RWTPtrDlistIterator<T>
RWTPtrHashMap<Key,Type,Hash,EQ> 
RWTPtrHashMapIterator<Key,Type,Hash,EQ>
RWTPtrHashMultiMap<Key,Type,Hash,EQ>
RWTPtrHashMultiMapIterator<Key,Type,Hash,EQ>
RWTPtrHashMultiSet<T,Hash,EQ>
RWTPtrHashMultiSetIterator<T,Hash,EQ>
RWTPtrHashSet<T,Hash,EQ>
RWTPtrHashSetIterator<T,Hash,EQ>
RWTPtrMap<Key,Type,Compare>
RWTPtrMapIterator<Key,Type,Compare>
RWTPtrMultiMap<Key,Type,Compare>
RWTPtrMultiMapIterator<Key,Type,Compare>
RWTPtrMultiSet<T,Compare>
RWTPtrMultiSetIterator<T,Compare>
RWTPtrOrderedVector<T>
RWTPtrSet<T,Compare>
RWTPtrSetIterator<T,Compare>
RWTPtrSlist<T>
RWTPtrSlistIterator<T>
RWTPtrSlistDictionary<KeyP,ValP> 
RWTPtrSlistDictionaryIterator<KeyP,ValP>
RWTPtrSortedDlist<T,Compare>
RWTPtrSortedDlistIterator<T,Compare>
RWTPtrSortedVector<T,Compare>
RWTPtrVector<T>
RWTQueue<T,Container>
RWTRegularExpression<charT>
RWTStack<T,Container>
RWTValDeque<T>
RWTValDlist<T>
RWTValDlistIterator<T>
RWTValHashMap<Key,Type,Hash,EQ>
RWTValHashMapIterator<Key,Type,Hash,EQ>
RWTValHashMultiMap<Key,Type,Hash,EQ>
RWTValHashMultiMapIterator<Key,Type,Hash,EQ>
RWTValHashMultiSet<T,Hash,EQ>
RWTValHashMultiSetIterator<T,Hash,EQ>
RWTValHashSet<T,Hash,EQ>
RWTValHashSetIterator<T,Hash,EQ>
RWTValMap<Key,Type,Compare>
RWTValMapIterator<Key,Type,Compare>
RWTValMultiMap<Key,Type,Compare>
RWTValMultiMapIterator<Key,Type,Compare>
RWTValMultiSet<T,Compare>
RWTValMultiSetIterator<T,Compare>
RWTValOrderedVector<T>
RWTValSet<T,C>
RWTValSetIterator<T,C>
RWTValSlist<T>
RWTValSlistIterator<T>
RWTValSlistDictionary<Key,V>
RWTValSlistDictionaryIterator<Key,V>
RWTValSortedDlist<T,Compare>
RWTValSortedDlistIterator<T,Compare>
RWTValSortedVector<T>
RWTValVector<T>
RWTValVirtualArray<T>
RWvios
       RWios (virtual)
                RWvistream
                       RWbistream  (&ios: virtual)
                              RWeistream
                       RWpistream
                         RWXDRistream  (&RWios)
                RWvostream
                       RWbostream  (&ios: virtual)
                              RWeostream
                         RWpostream
                         RWXDRostream  (&RWios)
RWVirtualPageHeap
       RWBufferedPageHeap
                RWDiskPageHeap
RWWString
RWWSubString
RWWTokenizer
RWZone
       RWZoneSimple
streambuf
       RWAuditStreamBuffer
       RWCLIPstreambuf
                RWDDEstreambuf
xmsg
       RWxmsg
                RWExternalErr
                       RWFileErr
                       RWStreamErr
                RWInternalErr
                       RWBoundsErr
                RWxalloc