创建和使用静态库 (C++)

更新:2007 年 11 月

我们将创建的下一个库类型是静态库 (LIB)。使用静态库是重用代码的一种绝佳方式。您不必在自己创建的每个程序中重新实现同一例程,而只需对这些例程编写一次,然后从需要该功能的应用程序引用它们即可。

本演练涵盖以下内容:

  • 创建新的静态库项目。

  • 向静态库添加类。

  • 创建引用静态库的应用程序。

  • 在控制台应用程序中使用静态库的功能。

  • 运行应用程序。

先决条件

本主题假定您具备 C++ 语言的基础知识。

创建新的静态库项目

  1. 从“文件”菜单中,选择“新建”,然后选择“项目…”。

  2. 在“项目类型”窗格中,选择“Visual C++”下的“Win32”。

  3. 在“模板”窗格中,选择“Win32 控制台应用程序”。

  4. 为项目选择一个名称,如“MathFuncsLib”,并将其输入“名称”字段。为解决方案选择一个名称,如“StaticLibrary”,并将其输入“解决方案名称”字段。

  5. 按“确定”启动“Win32 应用程序向导”。在“Win32 应用程序向导”对话框的“概述”页中,按“下一步”。

  6. 在“Win32 应用程序向导”的“应用程序设置”页中,选择“应用程序类型”下的“静态库”。

  7. 在“Win32 应用程序向导”的“应用程序设置”页中,清除“附加选项”下的“预编译头”复选框。

  8. 按“完成”创建项目。

向静态库添加类

  1. 若要为新类创建头文件,请从“项目”菜单中选择“添加新项…”。将显示“添加新项”对话框。从“类别”窗格中,选择“Visual C++”下的“代码”。从“模板”窗格中选择“头文件(.h)”。为头文件选择一个名称,如“MathFuncsLib.h”,并按“添加”。将显示一个空白文件。

  2. 添加一个名为“MyMathFuncs”的简单类,以执行常见的算术运算,如加、减、乘和除。代码应与以下内容类似:

    // MathFuncsLib.h
    
    namespace MathFuncs
    {
        class MyMathFuncs
        {
        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
            // Throws DivideByZeroException if b is 0
            static double Divide(double a, double b);
        };
    }
    
  3. 若要为新类创建源文件,请从“项目”菜单中选择“添加新项…”。将显示“添加新项”对话框。从“类别”窗格中,选择“Visual C++”下的“代码”。从“模板”窗格中,选择“C++ 文件(.cpp)”。为源文件选择一个名称,如“MathFuncsLib.cpp”,并按“添加”。将显示一个空白文件。

  4. 在源文件中实现“MyMathFuncs”的功能。代码应与以下内容类似:

    // MathFuncsLib.cpp
    // compile with: /c /EHsc
    // post-build command: lib MathFuncsLib.obj
    
    #include "MathFuncsLib.h"
    
    #include <stdexcept>
    
    using namespace std;
    
    namespace MathFuncs
    {
        double MyMathFuncs::Add(double a, double b)
        {
            return a + b;
        }
    
        double MyMathFuncs::Subtract(double a, double b)
        {
            return a - b;
        }
    
        double MyMathFuncs::Multiply(double a, double b)
        {
            return a * b;
        }
    
        double MyMathFuncs::Divide(double a, double b)
        {
            if (b == 0)
            {
                throw new invalid_argument("b cannot be zero!");
            }
    
            return a / b;
        }
    }
    
  5. 若要将项目生成为静态库,请从“项目”菜单中选择“MathFuncsLib属性…”。在左窗格中,选择“配置属性”下的“常规”。在右窗格中,将“配置类型”更改为“静态库(.lib)”。按“确定”保存更改。

    说明:

    如果是从命令行生成,必须分两个步骤来生成程序。首先,通过使用带编译器选项 /cCl.exe 编译代码 (cl /c /EHsc MathFuncsLib.cpp)。这将创建名为“MathFuncsLib.obj”的对象文件。有关更多信息,请参见 /c(编译但不链接)。接着,使用库管理器 Lib.exe 链接代码 (lib MathFuncsLib.obj)。这将创建静态库“MathFuncsLib.lib”。有关库管理器的更多信息,请参见LIB 引用

  6. 编译该静态库,方法是选择“生成”菜单中的“生成解决方案”。这将创建一个可供其他程序使用的静态库。

创建引用静态库的应用程序

  1. 若要创建引用并使用刚刚创建的静态库的应用程序,请从“文件”菜单中选择“新建”,然后选择“项目…”。

  2. 在“项目类型”窗格中,选择“Visual C++”下的“Win32”。

  3. 在“模板”窗格中,选择“Win32 控制台应用程序”。

  4. 为项目选择一个名称(如“MyExecRefsLib”),并将其键入“名称”字段。从“解决方案”旁边的下拉列表中选择“添入解决方案”。这会将新项目添加到该静态库所属的同一个解决方案中。

  5. 按“确定”启动“Win32 应用程序向导”。在“Win32 应用程序向导”对话框的“概述”页中,按“下一步”。

  6. 在“Win32 应用程序向导”的“应用程序设置”页中,选择“应用程序类型”下的“控制台应用程序”。

  7. 在“Win32 应用程序向导”的“应用程序设置”页中,清除“附加选项”下的“预编译头”。

  8. 按“完成”创建项目。

在控制台应用程序中使用静态库的功能

  1. 创建新的控制台应用程序后,该向导将为您创建一个空程序。源文件的名称与您在前面为项目选择的名称相同。在本示例中,名为“MyExecRefsLib.cpp”。

  2. 若要使用在静态库中创建的算术例程,必须引用该静态库。为此,请选择“项目”菜单中的“引用…”。在“属性页”对话框中,展开“通用属性”节点,并选择“引用”。然后选择“添加新引用…”按钮。有关“引用...”对话框的更多信息,请参见“<Projectname> 属性页”对话框 ->“通用属性”->“框架和引用”

  3. 显示“添加引用”对话框。此对话框列出了所有可以引用的库。“项目”选项卡列出了当前解决方案中的所有项目,以及它们包含的所有库。在“项目”选项卡中,选择“MathFuncsLib”。然后选择“确定”。有关“添加引用”对话框的更多信息,请参见“添加引用”对话框

  4. 若要引用静态库的头文件,必须修改包含目录路径。为此,请在“属性页”对话框中,展开“配置属性”节点,然后展开“C/C++”节点,并选择“常规”。在“附加包含目录”旁边,键入“MathFuncsLib.h”头文件所在位置的路径。

  5. 现在,可以在应用程序中使用“MyMathFuncs”类了。使用以下代码替换“MyExecRefsLib.cpp”的内容:

    // MyExecRefsLib.cpp
    // compile with: /EHsc /link MathFuncsLib.lib
    
    #include <iostream>
    
    #include "MathFuncsLib.h"
    
    using namespace std;
    
    int main()
    {
        double a = 7.4;
        int b = 99;
    
        cout << "a + b = " <<
            MathFuncs::MyMathFuncs::Add(a, b) << endl;
        cout << "a - b = " <<
            MathFuncs::MyMathFuncs::Subtract(a, b) << endl;
        cout << "a * b = " <<
            MathFuncs::MyMathFuncs::Multiply(a, b) << endl;
        cout << "a / b = " <<
            MathFuncs::MyMathFuncs::Divide(a, b) << endl;
    
        return 0;
    }
    
  6. 通过从“生成”菜单中选择“生成解决方案”,生成可执行文件。

运行应用程序

  1. 确保选择“MyExecRefsLib”作为默认项目。在“解决方案资源管理器”中,选择“MyExecRefsLib”,然后选择“项目”菜单中的“设为启动项目”。

  2. 若要运行项目,请选择“调试”菜单中的“开始执行(不调试)”。输出应该与下面的内容类似:

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

后续步骤

上一部分:创建和使用动态链接库 (C++) | 下一部分:创建和使用托管程序集 (C++)

请参见

任务

Visual C++ 指导教程

部署程序 (C++)

其他资源

常见编程方法

部署 (C++)