• 9.1 生成
• 9.2 例

RWBTreeOnDisk クラスは、ディスク上のファイルで B ツリーを管理するために設計されています。このクラスは、キーと値の関連付けを順序よく並べたコレクションを表わします。その順序はキーを比較することによって内部的に決定されます。キーを指定すると、値を取り出すことができます。キーの重複は許可されません。

キーは char の配列で、キーの長さはコンストラクタによって設定されます。B ツリー内の順序は、キーを外部関数 (変更可能) と比較することによって決定されます。

値の型は次のとおりです。

typedef long RWstoredValue;

値は通常、オブジェクトが格納されているファイル内の場所へのオフセットを表わします。キーを指定すると、オブジェクトが格納されている位置を見つけ、それを取り出すことができます。ただし、RWBTreeOnDisk クラスに関するかぎり、この値は特別な意味を持ちません。これを解釈するのはプログラマ次第です。

RWBTreeOnDisk クラスは、RWFileManager クラスを使って B ツリーノードの領域の割り当ておよび解放を管理します。B ツリーとデータが同じファイル内にある場合は、同じ RWFileManager を使って、オブジェクト自体の領域を管理できます。または、別の RWFileManager を使って別のファイルを管理し、B ツリーとデータを別々のファイルに格納することも可能です。

RWBTreeOnDisk クラスのメンバ関数は、メモリにおける RWBTreeDictionary クラスのメンバ関数と似ています。違う点は、キーが RWCollectable ではなく、char の配列であることです。メンバ関数には、キーと値のペアを追加する、ペアを削除する、キーに関連付けられている値を置き換える、キーに関連付けられている情報を照会する、キーと値の全ペアで順序正しく操作する、ツリーに項目数を返す、キーがツリーに含まれているかどうかを決定する、などの関数があります。

• 4.1 例
• 4.2 コンストラクタ

クラス RWDate はユリウス日の数値として格納された日付を表わします。ユリウス日による表現は便利なため、ソフトウェアでは一般的に用いられています。これにより迅速な暦の計算ができ、うるう年などの詳細にわずらわされることなく、一般の日付形式間との変換を簡単に行えます。

ユリウス日の数値は、Tools.h++ で簡単に求めることができます。一般の日付をユリウス日番号に変換するために Tools.h++ が使用するアルゴリズムは、ACM の 『Communications』 Volume6、No. 8、1963 年 8 月付けの 444 ページにある「Algorithm 199」に掲載されています。

グレゴリ暦は現在ほとんど世界中で使用されており、これはローマ法王グレゴリ 13 世によって 1582 年に導入され、その後各国に広まりました。グレゴリ暦は、1752 年 9 月 14 日に英国で受け入れられ、その後アメリカにやってきました。グレゴリ暦の由来を説明したのには理由があります。グレゴリ暦の導入以前の日付に対する RWDate は、グレゴリ方式から推定して求めることしかできないのです。そのような日付に対して、RWDate の出力、またはそのメソッドを使って日や月を処理することは、予期しない結果を招くことがあります。

• 6.1 特殊仮想ストリーム
• 6.2 単純な例
• 6.3 Windows クリップボードと DDE Streambuf
• 6.4 DDE の例
• 6.5 RWAuditStreamBuffer
• 6.6 まとめ

各 C++ コンパイラに付属の iostream 機能は、C++ の開発者に広く理解されている機能です。その利点には、ストリームへの挿入および抽出における型保証、新しい型への拡張性、およびストリームバイトのソースおよび宛先のユーザへの透過性があげられます。これらは、streambuf クラスによって設定されます。

ただし、iostream 機構には、数多くの制限があり、フォーマット機能が特に問題になります。例えば、ostream に倍精度のデータを挿入する場合、それをバイナリとして挿入するような型保証はありません。さらに、すべてのバイトソースと宛先が streambuf のモデルに適合するわけではありません。XDR など多くのプロトコルの場合、形式は本質的にバイトストリームに結び付けられていて、切り離すことができません。

Rogue Wave の仮想ストリーム機能は、ストリームの理想的なモデルを提供することによって、これらの制限を克服しており、形式やストリームモデムによって制約を受けることがありません。Rwvios クラスは仮想ストリームクラス階層のルートにあります。これは、標準ライブラリクラス ios と同様のインタフェースを持つ抽象基底クラスです。

 class RWvios{
public:
  virtual int   eof()             = 0;
  virtual int   fail()            = 0;
  virtual int   bad()             = 0;
  virtual int   good()            = 0;
  virtual int   rdstate()         = 0;
  virtual int   clear(int v = 0)  = 0;
};

RWvios から派生したクラスは、これらの関数を定義します。

抽象基底クラス RWvistream と RWvostream は、Rwvios を継承しています。これらのクラスは、すべての基本的な組み込み型および組み込み型の配列に対して、operator<<()、put()、get() などの純粋仮想関数を宣言しています。

 class RWvistream : public RWvios {
public:
  virtual Rwvistream&  operator>>(char&)       = 0;
  virtual Rwvistream&  operator>>(double&)     = 0;
  virtual int          get()                   = 0;
  virtual Rwvistream&  get(char&)              = 0;
  virtual Rwvistream&  get(double&)            = 0;
  virtual Rwvistream&  get(char*, size_t N)    = 0;
  virtual Rwvistream&  get(double*, size_t N)  = 0;
  .
  .
  .
};

class RWvostream : public RWvios {
public:
  virtual Rwvostream&  operator<<(char)             = 0;
  virtual Rwvostream&  operator<<(double)           = 0;
  virtual Rwvostream&  put(char)                    = 0;
  virtual Rwvostream&  put(double)                  = 0;
  virtual Rwvostream&  put(const char*, size_t N)   = 0;
  virtual Rwvostream&  put(const double*, size_t N) = 0;
  .
  .
  .
};

RWvistream と RWvostream を継承したストリームは、ユーザにわかりやすい形式で、組み込みを特殊ストリームに格納するものです。

仮想ストリーム機能の基本的機能は、形式に関係なく仮想出力ストリームに組み込みを挿入したり、抽出したりすることにあります。つまり、空白類、コンマなどで出力をフォーマットする必要がないということです。つまり、「ここは倍精度です。都合のいい形式で保存して、戻して欲しいと言ったときにそれを正しい形式で取り出してください」と Rwvostream に効果的に指示しているわけです。

このクラスは、非常に強力で、使用する最終出力媒体または形式を一切知らなくても、ストリーム演算子を書いたり使用することができます。例えば、出力媒体はディスク、メモリ領域、あるいはネットワークのどれでもかまいません。さらに、バイナリ、ASCII、またネットワークパケットなど、どの形式にも対応しています。これらいずれの場合も、同じストリーム演算子を使用します。

定数

#define FALSE 0                         // RWBoolean 値 (defs.h)

#define TRUE 1                          // RWBoolean 値 (defs.h)

#define rwnil 0                         // nil ポインタ (defs.h)

#define RWTOOLS 0x700                   // (実際の現在のバージョン番号)
                                        // number) (tooldefs.h)

const RWoffset RWNIL = -1L;             // RWFile にはオフセットがない
                                        // (defs.h)

const size_t RW_NPOS = ~(size_t)0;      // 配列へのインデックスが
                                        // 見つからない (defs.h)

Typedef

typedef unsigned short RWClassID;       // (defs.h)      各クラスで一意

typedef int RWBoolean;                  // (defs.h)      TRUE または FALSE

typedef unsigned char RWByte;           // (defs.h)      ビットフラッグ アトム

typedef RWCollectable* RWCollectableP   // (tooldefs.h)  トークン化に必要

typedef unsigned short RWErrNo          // (defs.h)      エラー処理に使用

typedef long RWoffset;                  // (tooldefs.h)  ファイルオフセットに使用

typedef unsigned long RWspace;          // (tooldefs.h)  ファイルレコードに使用

typedef long RWstoredValue;             // (tooldefs.h)  ファイルオフセットに使用

typedef void* RWvoid;                   // (tooldefs.h)  void* の配列用

関数へのポインタ

typedef void                 (*RWapplyCollectable)    (RWCollectable*, void*);

typedef void                 (*RWapplyGeneric)        (void*, void*);

typedef void                 (*RWapplyKeyAndValue)    (RWCollectable*,
                                                      RWCollectable*, void*);

typedef void                 (*RWauditFunction)       (unsigned char, void*);

typedef void                 (*RWdiskTreeApply)       (const char*,
                                                      RWstoredValue, void*);

typedef int                  (*RWdiskTreeCompare)     (const char*, const char*,
                                                      size_t);

typedef RWBoolean            (*RWtestGeneric)         (const void*, const void*);

typedef RWBoolean            (*RWtestCollectable)     (const RWCollectable*,
                                                      const void*);

typedef RWBoolean            (*RWtestCollectablePair) (const RWCollectable*,
                                                      constRWCollectable*,void*);

typedef RWCollectable*       (*RWuserCreator)         ();

Enumerations

enum RWSeverity {RWWARNING, RWDEFAULT, RWFATAL}

以下は、関連するクラスのメンバ関数やコンストラクタの動作を変更します。太字で示されている値は、デフォルト値です。

RWCString::enum stripType       {leading,trailing,both}        // 文字を剥ぎ取る場所

RWCString::enum caseCompare     {exact, ignoreCase}            // 比較中に大文字小文字
                                                                  // の区別をしない
RWCString::enum scopeType       {one, all}                     // 置換する部分文字列
                                                                  // の数

RWBTreeOnDisk::enum styleMode   {V6Style, V5Style}             // ファイル形式

RWBTreeOnDisk::enum createMode  {autoCreate, create}           //(再使用,新規作成)
                                                                  // ファイルの B-ツリー

RWeostream::enum Endian         { LittleEndian,                   // コンストラクタ
                                BigEndian, HostEndian }

                                                                  // 引数

RWLocale::enum CurrSymbol       { NONE, LOCAL, INTL }          // 「asString」メソッド
                                                                  // で使用

RWWString::enum stripType       {leading,trailing,both}        // 文字を剥ぎ取る場所

RWWString::enum caseCompare     {exact, ignoreCase}            // 比較中に大文字小文字
                                                                  // の区別をしない

RWWString::enum scopeType       {one, all}                     // 置換する部分文字列
                                                                  // の数

Tools.h++ の公開マクロ

これらのマクロは、Tools.h++ API の一部としてユーザが使用できるように、定義されています。

collect.h ファイル

// マクロの本体は記載されていない。『Tools.h++ Class Reference』のRwcollectable
// およびこのマニュアルを参照。
#define RWDECLARE_ABSTRACT_COLLECTABLE(className)
#define RWDEFINE_ABSTRACT_COLLECTABLE(className)
#define RWDECLARE_COLLECTABLE(className)
#define RWDEFINE_COLLECTABLE(className,id)
#define RWDEFINE_NAMED_COLLECTABLE(className,str)

defs.h ファイル

// RWDEBUG が定義されるときに以下のように定義する。それ以外の場合は、何も定義しない。
#define RWPOSTCONDITION(a)    assert( (a) != 0 )
#define RWPRECONDITION2(a,b)  assert( (a) != 0 )
#define RWPOSTCONDITION2(a,b) assert( (a) != 0 )
#define RWPRECONDITION2(a,b)  assert((b, (a) !=0))
#define RWPOSTCONDITION2(a,b) assert((b, (a) !=0))
#define RWASSERT(a)           assert( (a) != 0 )

edefs.h ファイル

// マクロの本体は記載されていない。第 14 章「永続性」を参照。
#define RWDECLARE_PERSISTABLE_IO(CLASS,ISTR,OSTR)
#define RWDECLARE_PERSISTABLE_TEMPLATE_IO(TEMPLATE, ISTR, OSTR)
#define RWDECLARE_PERSISTABLE_TEMPLATE_IO_2(TEMPLATE, ISTR, OSTR)
#define RWDECLARE_PERSISTABLE_TEMPLATE_IO_3(TEMPLATE, ISTR, OSTR)
#define RWDECLARE_PERSISTABLE_TEMPLATE_IO_4(TEMPLATE, ISTR, OSTR)
#define RWDECLARE_PERSISTABLE(CLASS)
#define RWDECLARE_PERSISTABLE_TEMPLATE(TEMPLATE)
#define RWDECLARE_PERSISTABLE_TEMPLATE_2(TEMPLATE)
#define RWDECLARE_PERSISTABLE_TEMPLATE_3(TEMPLATE)
#define RWDECLARE_PERSISTABLE_TEMPLATE_4(TEMPLATE)

epersist.h ファイル

// マクロの本体は記載されていない。第 14 章「永続性」を参照。
#define RWDEFINE_PERSISTABLE_IO(CLASS,ISTR,OSTR)
#define RWDEFINE_PERSISTABLE_TEMPLATE_IO(TEMPLATE,ISTR,OSTR)
#define RWDEFINE_PERSISTABLE_TEMPLATE_IO_2(TEMPLATE,ISTR,OSTR
#define RWDEFINE_PERSISTABLE_TEMPLATE_IO_3(TEMPLATE,ISTR,OSTR)
#define RWDEFINE_PERSISTABLE_TEMPLATE_IO_4(TEMPLATE,ISTR,OSTR)
#define RWDEFINE_PERSISTABLE(CLASS)
#define RWDEFINE_PERSISTABLE_TEMPLATE(TEMPLATE)
#define RWDEFINE_PERSISTABLE_TEMPLATE_2(TEMPLATE)
#define RWDEFINE_PERSISTABLE_TEMPLATE_3(TEMPLATE)
#define RWDEFINE_PERSISTABLE_TEMPLATE_4(TEMPLATE)

strmshft.h ファイル

// 便利なマクロ
#define RW_PROVIDE_DVSTREAM_INSERTER(DerivedOstream,vstreamable)
#define RW_PROVIDE_DVSTREAM_EXTRACTOR(DerivedIstream,vstreamable)

tphasht.h、tvhasht.h、tphdict.h、tvhdict.h、tphmmap.h、tvhmmap.h、tphset.h、tvhset.h
の各ファイル

// 現在のコンパイラと ANSI 準拠のコンパイラ間で移植可能なコードを
// 書く場合に便利。
// テンプレートを参照
#define RWDefHArgs(T) ,RWTHasher<T>,equal_to<T>

In files tpsrtvec.h, tvsrtvec.h

// 現在のコンパイラと ANSI 準拠のコンパイラ間で移植可能なコードを
// 書く場合に便利。
// テンプレートを参照
#define RWDefCArgs(T) ,less<T>

Smalltalk 標準インタフェース

(RW_STD_TYPEDEFS を定義することでアクティブになる)

typedef     RWBag                         Bag;
typedef     RWBagIterator                 BagIterator;
typedef     RWBinaryTree                  SortedCollection;
typedef     RWBinaryTreeIterator          SortedCollectionIterator;
typedef     RWBitVec                      BitVec
typedef     RWCollectable                 Object;    // All-too-common type!
typedef     RWCollectableDate             Date;
typedef     RWCollectableInt              Integer;
typedef     RWCollectableString           String;
typedef     RWCollectableTime             Time;
typedef     RWCollection                  Collection;
typedef     RWHashDictionary              Dictionary;
typedef     RWHashDictionaryIterator      DictionaryIterator;
typedef     RWIdentityDictionary          IdentityDictionary;
typedef     RWIdentitySet                 IdentitySet;
typedef     RWOrdered                     OrderedCollection;
typedef     RWOrderedIterator             OrderedCollectionIterator;
typedef     RWSequenceable                SequenceableCollection;
typedef     RWSet                         Set;
typedef     RWSetIterator                 SetIterator;
typedef     RWSlistCollectables           LinkedList;
typedef     RWSlistCollectablesIterator   LinkedListIterator;
typedef     RWSlistCollectablesQueue      Queue;
typedef     RWSlistCollectablesStack      Stack;

A.1.1 選択チャートの使い方

選択チャートを見やすくするために、各選択肢の質問は簡潔になっています。次に、選択肢の質問について解説します。

コレクション内のデータの順序には意味がありますか?

コレクションの中には、コレクション内のデータの位置を制御できるものがあります。例えば、配列やベクトル、およびリンクリストはデータを「順序付きで」提示します。特定の順序で、または数値インデックスに基づいてデータにアクセスする必要がある場合、順序には意味があります。

重複項目を許可しますか?

コレクションの中には、コレクション内にすでに存在している項目と等しい項目を挿入できないものがあります (通常、この種のコレクションはセットと呼ばれます)。別の種類のコレクションには、複数の同一項目を保持する様々な方法があり、重複項目の挿入を許可します。Tools.h++ コレクションには、重複を調べる機構と重複項目を保持する機構の両方が備えられています。

順序付けは本質的なものですか、それとも外部的なものですか?

コレクション内のデータがそれを挿入する方法によって制御される場合は、「順序が外部的に決定される」と言います。例えば、ベクトルやリンクリストは、外部的に順序付けられています。データがコレクションによって使用されるアルゴリズムによって決定された位置に格納される場合は、順序付けは「本質的」です。例えば、格納されたベクトルやバランスツリーは本質的な順序を持ちます。

外部キーによってデータにアクセスしますか?

値とは異なるキーを基準にして値にアクセスする場合、「外部キーによってデータにアクセスする」と言います。例えば、「電話番号リスト」は、電話番号というデータを、名前の形式をとったキーに関連付けます。逆に、「委員会メンバのリスト」は、名前の形をとったデータだけになります。情報を取得するためには、キーを必要としません。

数値インデックスでデータにアクセスしますか?

配列またはベクトルに格納されているオブジェクトには、数値インデックスでアクセスします。例えば、数値インデックス「12」を用いてオブジェクトを見つけ、12
という位置にあるオブジェクトにアクセスします。

自身との比較によってデータにアクセスしますか?

明示的なインデックスやキーのいずれとも一緒に格納されていないデータは、検索データとコレクション内のデータの一致を探すことによって見つけることができます。前述した委員会メンバのリストは、この種類のデータの例です。Set や Bag は自身との比較によってアクセスするコレクションの例です。

自身との比較によってデータにアクセスする場合は、どの種類の一致基準を使用するかを知る必要があります。一致には、あるオブジェクトを別のオブジェクトと直接比較する「等値性」を基準にすることも、オブジェクトのアドレスを比較し、オブジェクトが同一であるかどうかを調べる「アイデンティティ」を基準にすることもできます。

最適のアクセス方式は、リンクノードによるものですか?

リンクノードを利用するコレクションは、通常リストと呼ばれます。リストでは、コレクションの両端にあるデータに素早くアクセスでき、コレクションの真ん中にデータを効率よく挿入することができます。ただし、コレクションの真ん中にあるデータに頻繁にアクセスする必要がある場合、リストは他のコレクションに比べてそれほど効率的ではありません。

頻繁にアクセスするデータがコレクションの両端にありますか?

処理しなければならないデータの量が分からない場合は頻繁にありますが、処理するほとんどのデータは、コレクションの最も新しいデータか、最も古いデータです。最後に追加されたデータを処理するのに最も効率的なのは、「後入れ先出し」方式を持つコレクションです。後入れ先出し (LIFO) のコンテナは「スタック」です。先入れ先出し (FIFO) 方式でデータを処理するコレクションは、「待ち行列」と呼ばれます。最新データと最古データの両方に効率的にアクセスできるコレクションは、「両頭列」あるいは Deque (Double Ended Queue) と呼ばれます。

リンクリストの場合－データにリストの一方からだけ、または両方からアクセスする必要がありますか?

一重リンクリストはサイズが小さいのですが、リストの「正面」からだけアクセスできます。二重リンクリストは、より柔軟性のあるアクセス方式を持ちますが、格納されている各オブジェクトごとに追加のポインタを必要とします。

数値インデックスでアクセスするコレクションの場合－コレクションを自動的にサイズ変更する必要がありますか?

コレクションに格納する項目の最大数があらかじめ分かっている場合は、固定サイズのコレクションを選択する方がより効率的に挿入と削除を行うことができます。反対に、ほとんど無制限に拡張する必要がある場合は、現在格納しているデータ量に合わせて自動的にサイズを調整するコレクションを選択するべきです。

A.1.2 その他の選択基準

どのコレクションを選択するかは、これまでの経験や直観を含め、数多くの要素に依存します。選択チャートの質問の他に、どのコレクションを選択するかを決める上で次の質問も考慮してください。

複数コレクションで単一オブジェクトを保持する必要がありますか?

「はい」の場合は、ポインタベースのコレクションを使用します。

コピーするのに時間のかかるオブジェクトを収集しますか?

「はい」の場合は、ポインタベースのコレクションを使用します。

ポインタベースのコレクションを使用しなければならない理由がありますか?

「いいえ」の場合は、値ベースのコレクションを使用します。

コレクション内のオブジェクトの順序を外部的に制御しますか?

「はい」の場合は、ベクトルやリストなどのシーケンスコレクションを使用します。

挿入後、コレクション内の項目が変更可能である必要がありますか?

「はい」の場合は、シーケンスコレクションまたはマッピング (辞書) コレクションを使用します。マップと辞書は、不変のキーを持ちますが、値は変更可能です。

コレクションがオブジェクトの比較を基準に独自の順序を保持するようにしますか?

「はい」の場合は、セット、マップ、あるいはソート済みコレクションを使用します。

数値インデックスによってコレクション内のオブジェクトにアクセスしますか?

「はい」の場合は、シーケンスコレクションまたはソート済みコレクションを使用します。

非数値キーによって値を検索する必要がありますか?

「はい」の場合は、マップまたは辞書を使用します。

比較するオブジェクトを指定して、コレクション内のオブジェクトにアクセスしますか?

「はい」の場合は、セット、マップ、あるいはハッシュベースのコレクションを使用します。

意味のある順序付けをなしで済まし、その代わりメモリをキーによる定時間のルックアップに使いますか?

「はい」の場合は、ハッシュベースのコレクションを使用します。

必要に応じて拡張または縮小するコレクションで高速のルックアップと挿入が必要ですか?

「はい」の場合は、B-ツリー、あるいは新しい標準 C++ ライブラリを基にした連想コンテナを使用します。

メモリにデータすべてを読み込まずに、アクセスする必要がありますか?

RWBTreeOnDisk または RWTValVirtualArray を使用します。

• 第 3 章から第 5 章で説明されている、日付、時刻、文字列などを表わす単純クラス
• 第 11 章で説明されているテンプレートベースのコレクションクラス
• 第 12 章で説明されている、プリプロセッサ <generic.h> を使う汎用コレクションクラス

2.1.1 単純クラス

Tools.h++ には、軽量化された単純クラスが多く含まれています。軽量化されたクラスとは、時間のかからない初期設定子とコピーコンストラクタを持つクラスを意味します。単純クラスには、RWDate (日付)、 RWTime(時刻、各種の時間帯および地域に対応)、RWCString (シングルおよびマルチバイト文字列)、RWWString (ワイド文字)、および RWCRegexp または RWCRexpr (正規表現) などがあります。これらのクラスのほとんどは、4バイト以下で保持することができ、また非常に簡単なコピーコンストラクタ（通常1ビットコピー）を持ち、仮想関数は持っていません。Tools.h++ Class Referenceを参照してください。

2.1.2 テンプレートベースのコレクションクラス

テンプレートベースのコレクションクラス (略してテンプレート) には、速度と型保証という利点があります。しかし、コードサイズを減らすためには、あまり使わないようにしてください。テンプレートは多くの異なる型で使用できますが、各型がまったく新しいクラスを生成するために、コードサイズが大きくなる可能性があります。使用コンパイラで標準 C++ ライブラリが使える場合は、標準 C++ ライブラリをもとにしている Tools.h++ テンプレートベースコレクションを使用できます。使用コンパイラで標準 C++ ライブラリを使えない場合でも、11.3.1節および 11.10 節に説明されている、サブセットのテンプレートを使用できます。

2.1.3 汎用コレクションクラス

汎用コレクションクラスは、C++ コンパイラに付属しているプリプロセッサマクロ<generic.h> を使用するクラスです。このクラスは、テンプレートに対応していないコンパイラに対しては、型保証がされているために、テンプレートとほとんど同じように扱えます。このため、移植性が高いとも言えます。ただし、プリプロセッサにかなり依存しているため、この汎用コレクションクラスを含むコードで、デバッガを使用することが困難になる場合があります。さらに詳しくは、第 12 章を参照してください。

表 1.抽象基底クラスと機能

機能

クラス

参照箇所

Locale

RWLocale

16.4 節

時間帯

RWZone

16.4 節

仮想ストリーム

RWvistream RWvostream

第 6 章

多形永続性

RWCollectable

第 14 章

仮想ページヒープ

RWVirtualPageHeap

『Class Reference』

モデルビューコントローラ抽象化

RWModel RWModelClient

『Class Reference』

2.4.1永続性

Tools.h++ は、以下のメンバ関数を使ってClassName 型のオブジェクトを RWFile や Rogue Wave 仮想ストリームへ格納し、復元します。

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

ANSI-C ファイル I/O をカプセル化するクラス RWFile は、オブジェクトをバイナリ形式で保存します。その結果、ファイルへの格納と取り出しが効率的に行われます。RWFile について詳しくは、Tools.h++ User’s Guideの第 7 章を参照してください。

クラス RWvistream と RWvostream は Rogue Wave 仮想ストリーム機能が使用する抽象基底クラスです。最終の出力形式は、特殊クラスによって決定されます。例えば、RWpistream と RWpostreamは、それぞれ RWvistream と RWvostream から派生した 2 つのクラスです。これらのクラスは、移植可能な ASCII 形式を使ってオブジェクトを格納または取り出します。結果は異なるオペレーティングシステム間で転送することができます。これらのクラスについて詳しくは、Tools.h++ User’s Guide の第 6 章を参照してください。

RWFile または Rogue Wave ストリームのどちらに格納するかの判断は、ユーザに任されています。RWFileへの格納は、速い代わりに、別のホストマシンやオペレーティングシステムに結果を移植するときに制限が生じます。Rogue Wave ストリームへの格納は、速度に欠ける代わりに、異なるマシン間で移植可能な形式や、分散型計算のためのXDRストリームによるカプセル化などの、便利な機能を持つ特殊クラスが使えます。

2.4.2 格納サイズ

次の共通メンバ関数は、RWFileが ClassName 型オブジェクトを格納するのに必要な、二次格納領域のバイト数を返します。

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

メンバ関数は、次の関数を使用します。

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

上記のメンバ関数は、クラス RWFileManager および RWBTreeOnDisk
を使うオブジェクトを格納するときに便利です。RWCollectable から継承するオブジェクトの場合、2 番目のメンバ関数 recursiveStoreSize() は、再帰格納で使用されているバイト数を計算します。これは、次の関数を使用します。

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

あらゆるストリームに対して、RWAuditStreamBuffer クラスを使ってバッファに渡されるバイト数を数えることができます。つまり、このクラスは、上記のメンバ関数 recursiveStoreSize() がファイルに対して与えるのと同じ機能を、ストリームに提供します。RWAuditStreamBuffer について詳しくは、Tools.h++ Class Reference を参照してください。

2.4.3 ストリーム I/O

多重定義された左シフト演算子 << は、最初の引数として ostream オブジェクトをとり、人間が読める形式でオブジェクトの内容を出力します。逆に、多重定義された右シフト演算子 >> は、最初の引数として istream オブジェクトをとり、人間が読める形式でストリームからオブジェクトを読み取り、分割します。

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&);

永続性シフト演算子は、ストリームへ格納およびストリームから復元しますが、必ずしも「人間が読める」形式でそれを実行するとはかぎりません。

2.4.4 比較

ほとんどのクラスが比較と同等のメンバ関数を持ちます。

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;

ほとんどの Rogue Wave のクラスでは、非常に簡単な対策をとっており、ユーザがヒープ領域から何かを割り当てた場合は、それを解放するのは、そのユーザの責任になります。Rogue Wave ライブラリがヒープ領域から何かを割り当てた場合は、ライブラリが責任を持って解放します。

オブジェクトの作成に関しては、例外が 2 つあります。最初の例外は、演算子によるものです。

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

これらの演算子は、それぞれ RWFile または RWvistream からの RWCollectable を継承しているオブジェクトを復元します。これらは、ヒープ領域から割り当てられたオブジェクトへのポインタを返します。これを解放するのは、ユーザの責任です。

2 番目の例外は、メンバ関数によるものです。

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

この関数は、ある選択基準を満たすメンバとともに、ヒープ領域から割り当てられたコレクションへのポインタを返します。終了したら、このコレクションを削除するのもユーザの責任です。

また、オブジェクトの削除に関する例外もあります。多くのコレクションクラスでは、メソッド clearAndDestroy() を使うことができます。これは、コレクションからすべてのポインタを取り除き、それぞれ解放します。ただし、clearAndDestroy() を使用する場合は、そのコレクションのポインタすべてを削除しても問題が起きないかどうかを判断するのは、ユーザの責任となります。

これらのメソッドについて詳しくは、Tools.h++ Class Referenceを参照してください。