EB ライブラリ

[前へ] [次へ] [目次]

## ライブラリの初期化と後始末

この章からは、EB ライブラリのプログラミングについての解説になります。

まず、アプリケーションプログラムから EB ライブラリを利用するには、 最初にライブラリを初期化する必要があります。

ライブラリの初期化を行うには、`eb_initialize_library()` という関数を呼び出します。

>     if (eb_initialize_library() != EB_SUCCESS) {
>         printf("eb_initialize_library() failed\n");
>         exit(1);
>     }

同様に、ライブラリを使い終わったら、`eb_finalize_library()` という関数を呼び出して後始末をします。

>     eb_finalize_library();

### サンプルプログラム

>     /*                                                            -*- C -*-
>      * Copyright (c) 2001-2006  Motoyuki Kasahara
>      *
>      * Redistribution and use in source and binary forms, with or without
>      * modification, are permitted provided that the following conditions
>      * are met:
>      * 1. Redistributions of source code must retain the above copyright
>      *    notice, this list of conditions and the following disclaimer.
>      * 2. Redistributions in binary form must reproduce the above copyright
>      *    notice, this list of conditions and the following disclaimer in the
>      *    documentation and/or other materials provided with the distribution.
>      * 3. Neither the name of the project nor the names of its contributors
>      *    may be used to endorse or promote products derived from this software
>      *    without specific prior written permission.
>      *
>      * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
>      * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
>      * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
>      * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
>      * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
>      * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
>      * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
>      * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
>      * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
>      * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
>      * SUCH DAMAGE.
>      */

>     /*
>      * 使用方法:
>      *     initexit
>      * 例:
>      *     initexit
>      * 説明:
>      *     EB ライブラリの初期化、後始末をしてみます。
>      *     プログラムの外側から見れば、これは何の意味もない動作です。
>      */
>     #include <stdio.h>
>     #include <stdlib.h>

>     #include <eb/eb.h>
>     #include <eb/error.h>

>     int
>     main(int argc, char *argv[])
>     {
>         EB_Error_Code error_code;

>         /* EB ライブラリを初期化。*/
>         error_code = eb_initialize_library();
>         if (error_code != EB_SUCCESS) {
>             fprintf(stderr, "%s: failed to initialize EB Library, %s: %s\n",
>                 argv[0], eb_error_message(error_code), argv[1]);
>             exit(1);
>         }

>         /* EB ライブラリの利用を終了。*/
>         eb_finalize_library();
>         exit(0);
>     }

### 関数の詳細

この項で説明している関数を使うには、`eb/eb.h` を読み込んで下さい。

>     #include <eb/eb.h>

#### `EB_Error_Code eb_initialize_library ()`

関数 `eb_initialize_library()` は、EB ライブラリを初期化します。 アプリケーションプログラムは、EB ライブラリの他の関数を呼ぶ前に、必ず 一回だけこの関数を呼ぶ必要があります。

メッセージの国際化機能 (NLS) を有効にして EB ライブラリをコンパイル した場合、`eb_initialize_library()` は `bindtextdomain()` を 呼び出します。 したがって、アプリケーションプログラムが `setlocale()` を 呼び出すのは、この関数を呼び出す前である必要があります。

成功すると、関数は `EB_SUCCESS` を返します。 失敗すると、原因を示すエラーコードを返します。

ライブラリを初期化せずに、EB ライブラリの他の関数を呼んだ場合の動作は 未定義です。 また、すでに初期化を済ませた状態で、再度 `eb_initialize_library()` を呼んでもいけません。 呼んだ場合の動作は未定義です。

#### `void eb_finalize_library ()`

関数 `eb_finalize_library()` は、EB ライブラリを使い終わった 際の後始末を行います。 ただし、アプリケーションプログラム側で使用した `EB_Book`、`EB_Hookset`、`EB_Appendix` オブジェクトの後始末は行いません。 オブジェクトを後始末するには、それぞれ専用の関数 `eb_finalize_book()`、`eb_finalize_hookset()`、 `eb_finalize_appendix()` を各オブジェクトに対して別途 呼んでやる必要があります。

ライブラリの後始末をした後は、EB ライブラリのいかなる関数も呼んでは いけません。 呼んだ場合の動作は未定義です。

[前へ] [次へ] [目次]