チュートリアル: スタティック ライブラリを作成して使用する

このチュートリアルでは、C++ アプリケーションに使用するスタティック ライブラリ (.lib ファイル) を作成する方法について説明します。 スタティック ライブラリを使用すると、コードを有効に再利用できます。 機能を必要とするすべてのアプリで同じルーチンを再実装するのではなく、静的ライブラリに 1 回書き込んでからアプリから参照します。 静的ライブラリからリンクされたコードは、アプリの一部になります。 コードを使用するために別のファイルをインストールする必要はありません。

このチュートリアルでは、次の作業について説明します。

• スタティック ライブラリ プロジェクトを作成する

• スタティック ライブラリにクラスを追加する

• スタティック ライブラリを参照する C++ コンソール アプリを作成する

• アプリ内でスタティック ライブラリの機能を使用する

• アプリを実行する

前提条件

C++ 言語の基本の理解。

スタティック ライブラリ プロジェクトを作成する

プロジェクトを作成する手順は、お使いの Visual Studio のバージョンによって異なります。 優先するバージョンの Visual Studio のドキュメントを表示するには、 [バージョン] セレクター コントロールを使用します。 このページの目次の一番上にあります。

スタティック ライブラリにクラスを追加する

スタティック ライブラリにクラスを追加するには:

1. 新しいクラスのヘッダー ファイルを作成します。 ソリューション エクスプローラーで、MathLibrary を右クリックして、プロジェクトのコンテキスト メニューを開きます。 [追加]>[新しい項目] の順に選択します。

2. [ 新しい項目の追加] ダイアログで、 Visual C++>Code を選択します。 中央のウィンドウで、 [ヘッダー ファイル (.h)]をクリックします。 MathLibrary.h などのヘッダー ファイルの名前を指定し、[追加] を選択します。 ほとんど空白のヘッダー ファイルが表示されます。

3. 加算、減算、乗算、除算などの一般的な数値演算を行うための、Arithmetic という名前のクラスの宣言を追加します。 コードは次のようになります。

   // MathLibrary.h
   #pragma once
   
   namespace MathLibrary
   {
       class Arithmetic
       {
       public:
           // Returns a + b
           static double Add(double a, double b);
   
           // Returns a - b
           static double Subtract(double a, double b);
   
           // Returns a * b
           static double Multiply(double a, double b);
   
           // Returns a / b
           static double Divide(double a, double b);
       };
   }
   

4. 新しいクラスのソース ファイルを作成するには、ソリューション エクスプローラーで MathLibrary プロジェクトのコンテキスト メニューを開き、[追加>新しい項目] を選択します。

5. [ 新しい項目の追加 ] ダイアログの中央のウィンドウで、[ C++ ファイル ] (.cpp) を選択します。 MathLibrary.cpp など、ソース ファイルの名前を指定します。 その後、追加を選択します。 空白のソース ファイルが表示されます。

6. このソース ファイルを使って、Arithmetic クラスの機能を実装します。 コードは次のようになります。

   // MathLibrary.cpp
   // compile with: cl /c /EHsc MathLibrary.cpp
   // post-build command: lib MathLibrary.obj
   
   #include "MathLibrary.h"
   
   namespace MathLibrary
   {
       double Arithmetic::Add(double a, double b)
       {
           return a + b;
       }
   
       double Arithmetic::Subtract(double a, double b)
       {
           return a - b;
       }
   
       double Arithmetic::Multiply(double a, double b)
       {
           return a * b;
       }
   
       double Arithmetic::Divide(double a, double b)
       {
           return a / b;
       }
   }
   

7. スタティック ライブラリをビルドするには、メニュー バーで [ビルド]>[ソリューションのビルド] の順に選択します。 ビルドにより、他のプログラムで使用できる静的ライブラリ MathLibrary.lib が作成されます。

   注

   プログラムを Visual Studio のコマンド ラインからビルドする場合、2 つの処理によってビルドする必要があります。

   1. cl /c /EHsc MathLibrary.cppを実行してコードをコンパイルし、MathLibrary.objという名前のオブジェクト ファイルを作成します。cl コマンドはコンパイラ、Cl.exeを呼び出し、/c オプションはリンクせずにコンパイルを指定します。 詳細については、「 /c (リンクせずにコンパイルする)」を参照してください。
   2. lib MathLibrary.objを実行してコードをリンクし、スタティック ライブラリ MathLibrary.lib を作成します。 lib コマンドを実行すると、ライブラリ マネージャー Lib.exeが呼び出されます。 詳細については、 LIB リファレンスを参照してください。

スタティック ライブラリを参照する C++ コンソール アプリを作成する

アプリ内でスタティック ライブラリの機能を使用する

アプリでスタティック ライブラリの機能を使用するには:

1. その中で数学ルーチンを使用する前に、スタティック ライブラリを参照してください。 ソリューション エクスプローラーで MathClient プロジェクトのコンテキスト メニューを開き、[追加>参照] を選択します。

2. [ 参照の追加] ダイアログには、参照できるライブラリが一覧表示されます。 [プロジェクト] タブでは、現在のソリューション内のプロジェクトと、それらによって参照されるすべてのライブラリが一覧表示されます。 [ プロジェクト ] タブを開き、[ MathLibrary] を選択し、[ OK] を選択します。

3. 含まれているディレクトリ パスを変更して、 MathLibrary.h ヘッダー ファイルを参照します。 ソリューション エクスプローラーで MathClient を右クリックし、コンテキスト メニューを開きます。 [ プロパティ] を選択して、[ MathClient プロパティ ページ ] ダイアログを開きます。

4. [ MathClient プロパティ ページ ] ダイアログで、[ 構成 ] の値を [すべての構成] に設定します。 [プラットフォーム] を [すべてのプラットフォーム] に設定します。

5. [構成プロパティ]>[C/C++]>[全般] プロパティ ページを選択します。 [追加のインクルード ディレクトリ] プロパティで、MathLibrary ディレクトリへのパスを指定するか、参照します。

   ディレクトリ パスを参照するには、次のようにします。

   1. [追加のインクルード ディレクトリ] プロパティ値のドロップダウン リストを開き、[編集] を選択します。

   2. [ 追加のインクルード ディレクトリ ] ダイアログボックスで、テキスト ボックスの上部をダブルクリックします。 次に、行の末尾にある省略記号ボタン ([...]) を選択します。

   3. [ ディレクトリの選択 ] ダイアログで、レベルを上に移動し、 MathLibrary ディレクトリを選択します。 次に、[フォルダーの選択] ボタンを選択して、選択内容を保存します。

   4. [ 追加のインクルード ディレクトリ ] ダイアログで、[ OK] ボタンを選択します。

   5. [ プロパティ ページ ]ダイアログボックスで、[ OK] ボタンを選択して、プロジェクトへの変更を保存します。

6. これで、コードに Arithmetic ヘッダーを含めることによって、このアプリで #include "MathLibrary.h" クラスを使用できるようになりました。 MathClient.cpp の内容を次のコードに置き換えます。

   // MathClient.cpp
   // compile with: cl /EHsc MathClient.cpp /link MathLibrary.lib
   
   #include <iostream>
   #include "MathLibrary.h"
   
   int main()
   {
       double a = 7.4;
       int b = 99;
   
       std::cout << "a + b = " <<
           MathLibrary::Arithmetic::Add(a, b) << std::endl;
       std::cout << "a - b = " <<
           MathLibrary::Arithmetic::Subtract(a, b) << std::endl;
       std::cout << "a * b = " <<
           MathLibrary::Arithmetic::Multiply(a, b) << std::endl;
       std::cout << "a / b = " <<
           MathLibrary::Arithmetic::Divide(a, b) << std::endl;
   
       return 0;
   }
   

7. 実行可能ファイルをビルドするには、メニュー バーで [ビルド]>[ソリューションのビルド] の順に選択します。

アプリを実行する

アプリを実行するには:

1. MathClient が既定のプロジェクトとして選択されていることを確認します。 これを選択するには、ソリューション エクスプローラーで MathClient を右クリックしてコンテキスト メニューを開き、[スタートアップ Projectとして設定] を選択します。

2. メニュー バーの [デバッグ] > [デバッグなしで開始] を選択して、プロジェクトを実行します。 出力は次のようになります。

   a + b = 106.4
   a - b = -91.6
   a * b = 732.6
   a / b = 0.0747475
   

関連項目

チュートリアル: ダイナミック リンク ライブラリの作成と使用 (C++)