表1-3にTCtx
インタフェースで使用できるメソッドの概要を示します。
表1-3 TCtxメソッドの概要: Ctxパッケージ
関数 | 概要 |
---|---|
|
クラス・コンストラクタです。 |
|
XMLコンテキストで使用されるデータ・エンコーディングを取得します。 |
|
ユーザーが提供するエラー・ハンドラを取得します。 |
|
メモリー・アロケータを取得します。 |
|
データ・エンコーディングがシンプルかどうかを示すフラグを取得します。 |
|
データ・エンコーディングがUnicodeかどうかを示すフラグを取得します。 |
|
デストラクタ。領域をクリアし、実装を破棄します。 |
TCtxコンストラクタ。コンテキスト・オブジェクトの作成に失敗した場合、XmlException
をスローします。
構文 | 説明 |
---|---|
TCtx() throw (XMLException) |
このコンストラクタはコンテキスト・オブジェクトを作成し、デフォルト値のパラメータを使用してコンテキスト・オブジェクトを初期化します。 |
TCtx( oratext* name, ErrorHandler* errh = NULL, MemAllocator* memalloc = NULL, encodings* encs = NULL) throw (XMLException) |
このコンストラクタはコンテキスト・オブジェクトを作成し、ユーザーが指定したパラメータ値を使用してコンテキスト・オブジェクトを初期化します。 |
TCtx( oratext* name, up4 inpblksize, ErrorIfs* errh = NULL, MemAllocator* memalloc = NULL, encodings* encs = NULL) throw (XMLException) |
このコンストラクタはコンテキスト・オブジェクトを作成し、ユーザーが指定したパラメータ値を使用してコンテキスト・オブジェクトを初期化します。入力ソースからのメモリー・ブロック・サイズに関する追加パラメータをとります。 |
パラメータ | 説明 |
---|---|
name |
ユーザー定義のコンテキスト名 |
errh |
ユーザー定義のエラー・ハンドラ |
memalloc |
ユーザー定義のメモリー・アロケータ |
encs |
ユーザー指定のエンコーディング |
inpblksize |
入力ソースのメモリー・ブロック・サイズ |
戻り値
(TCtx)
コンテキスト・オブジェクト。
XMLコンテキストで使用されているデータ・エンコーディングを戻します。通常、データ・エンコーディングはユーザーが選択するため、この関数は必要ありません。ただし、データ・エンコーディングが指定されておらず、デフォルトが使用されている場合、この関数を使用して、デフォルトのエンコーディング名を戻すことができます。
構文
oratext* getEncoding() const;
戻り値
(oratext *)
データ・エンコーディングの名前。
このメンバー関数は、コンテキストが作成されたときにユーザーが指定したエラー・ハンドラを戻し、ユーザーが何も指定していない場合はNULL
を戻します。
構文
ErrorHandler* getErrHandler() const;
戻り値
(ErrorHandler *)
エラー・ハンドラ・オブジェクトへのポインタ、またはNULL
。
このメンバー関数は、コンテキストが作成されたときにユーザーが指定したメモリー・アロケータ、またはデフォルトのメモリー・アロケータを戻します。Cレベルのすべてのメモリー割当てについて、このメモリー・アロケータが使用される必要があります。
構文
MemAllocator* getMemAllocator() const;
戻り値
(MemAllocator*)
メモリー・アロケータ・オブジェクトへのポインタ。
コンテキストのデータ・エンコーディングが「シンプル」かどうか、すなわちASCIIやEBCDICのように各文字がシングルバイトであるかどうかを示すフラグを戻します。
構文
boolean isSimple() const;
戻り値
(boolean)
データ・エンコーディングが「シンプル」の場合はTRUE
、それ以外はFALSE
。
コンテキストのデータ・エンコーディングが、1文字に2バイトを使用するUnicode、UTF-16かどうかを示すフラグを戻します。
構文
boolean isUnicode() const;
戻り値
(boolean)
データ・エンコーディングがUnicodeの場合はTRUE
、それ以外はFALSE
。
デストラクタ。コンテキスト・オブジェクトが不要になった場合に、ユーザーがコールします。
構文
~Tctx();