Overzicht: Een statische bibliotheek maken en gebruiken

In dit stapsgewijze overzicht ziet u hoe u een statische bibliotheek (.lib-bestand) maakt voor gebruik met C++-apps. Het gebruik van een statische bibliotheek is een uitstekende manier om code opnieuw te gebruiken. In plaats van dezelfde routines opnieuw te gebruiken in elke app waarvoor de functionaliteit is vereist, schrijft u ze één keer in een statische bibliotheek en verwijst u ernaar vanuit de apps. Code die is gekoppeld vanuit een statische bibliotheek, wordt onderdeel van uw app. U hoeft geen ander bestand te installeren om de code te gebruiken.

Deze handleiding behandelt de volgende taken:

• Een statisch bibliotheekproject maken

• Een klasse toevoegen aan de statische bibliotheek

• Een C++-console-app maken die verwijst naar de statische bibliotheek

• De functionaliteit van de statische bibliotheek in de app gebruiken

• De app uitvoeren

Vereiste voorwaarden

Inzicht in de basisprincipes van de C++-taal.

Een statisch bibliotheekproject maken

De instructies voor het maken van het project variëren, afhankelijk van uw versie van Visual Studio. Als u de documentatie voor uw voorkeursversie van Visual Studio wilt bekijken, gebruikt u het besturingselement voor versie-selector . Deze bevindt zich boven aan de inhoudsopgave op deze pagina.

Een statisch bibliotheekproject maken in Visual Studio:

1. Kies op de menubalk Bestand>nieuw>Project om het dialoogvenster Een nieuwe project maken te openen.

2. Stel bovenaan het dialoogvenster Taal in op C++, stel Platform in op Windows en stel Projecttype in op Bibliotheek.

3. Selecteer in de gefilterde lijst met projecttypen Wizard voor Windows-bureaublad en kies vervolgens Volgende.

4. Voer op de pagina Uw nieuwe project configurerenMathLibrary in het vak Projectnaam in om een naam voor het project op te geven. Voer StaticMath in het vak Oplossingsnaam in. Kies de knop Maken om het dialoogvenster Windows-bureaubladproject te openen.

5. Selecteer statische bibliotheek (.lib) in het dialoogvenster Windows-bureaubladproject onder Toepassingstype.

6. Schakel onder Extra opties het selectievakje Vooraf gecompileerde header uit als dit is ingeschakeld. Selecteer Leeg project.

7. Kies OK om het project te maken.

Een klasse toevoegen aan de statische bibliotheek

Een klasse toevoegen aan de statische bibliotheek:

1. Maak een headerbestand voor een nieuwe klasse. Klik in Solution Explorer met de rechtermuisknop op MathLibrary om het contextmenu voor het project te openen. SelecteerNieuw item>.

2. Selecteer Visual C++>Code in het dialoogvenster Nieuw item toevoegen. Selecteer in het middelste deelvenster koptekstbestand (.h). Geef een naam op voor het headerbestand, zoals MathLibrary.h, en selecteer vervolgens Toevoegen. Er wordt een bijna leeg headerbestand weergegeven.

3. Voeg een declaratie toe voor een klasse met de naam Arithmetic om algemene wiskundige bewerkingen uit te voeren, zoals optellen, aftrekken, vermenigvuldigen en delen. De code moet er als volgt uitzien:

   // 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. Als u een bronbestand voor de nieuwe klasse wilt maken, opent u het contextmenu voor het project MathLibrary in Solution Explorer en kiest uVervolgens Nieuw itemtoevoegen>.

5. Selecteer in het dialoogvenster Nieuw item toevoegen in het middelste deelvenster C++-bestand (.cpp). Geef een naam op voor het bronbestand, zoals MathLibrary.cpp. Selecteer vervolgens Toevoegen. Er wordt een leeg bronbestand weergegeven.

6. Gebruik dit bronbestand om de functionaliteit voor klasse Arithmeticte implementeren. De code moet er als volgt uitzien:

   // 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. Als u de statische bibliotheek wilt bouwen, selecteert u Build Solution> op de menubalk. De build maakt een statische bibliotheek, MathLibrary.lib, die andere programma's kunnen gebruiken.

   Opmerking

   Wanneer u op de opdrachtregel van Visual Studio bouwt, moet u het programma in twee stappen bouwen.

   1. Voer cl /c /EHsc MathLibrary.cpp deze opdracht uit om de code te compileren en een objectbestand met de naam MathLibrary.obj te maken. Met cl de opdracht wordt de compiler aangeroepen, Cl.exeen de /c optie geeft compileer op zonder koppeling. Zie /c (Compileren zonder koppelen) voor meer informatie.
   2. Voer lib MathLibrary.obj uit om de code te koppelen en de statische bibliotheek MathLibrary.lib te maken. Met de lib opdracht wordt bibliotheekbeheer aangeroepen, Lib.exe. Zie LIB Reference voor meer informatie.

Een C++-console-app maken die verwijst naar de statische bibliotheek

Een C++-console-app maken die verwijst naar de statische bibliotheek in Visual Studio:

1. Klik in Solution Explorer met de rechtermuisknop op het bovenste knooppunt, Oplossing StaticMath, om het contextmenu te openen. KiesNieuw project> om het dialoogvenster Een nieuw project toevoegen te openen.

2. Stel boven aan het dialoogvenster het filter Projecttype in op Console.

3. Kies Console-app in de gefilterde lijst met projecttypen en kies vervolgens Volgende. Voer op de volgende pagina MathClient in als de naam voor het project.

4. Kies Maken om het clientproject te maken.

   Nadat u een console-app hebt gemaakt, wordt er een leeg programma voor u gemaakt. De naam voor het bronbestand is hetzelfde als de naam die u eerder hebt gekozen. In het voorbeeld heeft deze de naam MathClient.cpp.

De functionaliteit van de statische bibliotheek in de app gebruiken

De functionaliteit van de statische bibliotheek in de app gebruiken:

1. Verwijs naar de statische bibliotheek voordat u de wiskundige routines erin gebruikt. Open het contextmenu voor het MathClient-project in Solution Explorer en kies Verwijzing toevoegen>.

2. Het dialoogvenster Verwijzing toevoegen bevat de bibliotheken waarnaar u kunt verwijzen. Het tabblad Projecten bevat de projecten in de huidige oplossing en alle bibliotheken waarnaar ze verwijzen. Open het tabblad Projecten , selecteer MathLibrary en selecteer VERVOLGENS OK.

3. Wijzig het pad van de include-mappen zodat het verwijst naar het MathLibrary.h headerbestand. Klik in Solution Explorer met de rechtermuisknop op MathClient om het contextmenu te openen. Kies Eigenschappen om het dialoogvenster Eigenschappenpagina's van MathClient te openen.

4. Stel in het dialoogvenster Eigenschappenpagina's van MathClient de configuratiewaarde in op Alle configuraties. Stel Platform in op alle platforms.

5. Selecteer de eigenschappenpagina Configuratie-eigenschappen>C/C++>Algemeen . Geef in de eigenschap Extra includemapjes het pad van de MathLibrary-map op of blader ernaar.

   Volg deze stappen om naar de maplocatie te bladeren:

   1. Open de vervolgkeuzelijst van de eigenschapswaarde Aanvullende Include Directories en kies Bewerken.

   2. Dubbelklik in het dialoogvenster Extra mappen opnemen op de bovenkant van het tekstvak. Kies vervolgens de knop met het beletselteken (...) aan het einde van de regel.

   3. Navigeer in het dialoogvenster Map selecteren één niveau omhoog en selecteer vervolgens de map MathLibrary. Kies vervolgens de knop Map Selecteren om uw selectie op te slaan.

   4. Kies in het dialoogvenster Extra mappen opnemen de knop OK .

   5. Kies in het dialoogvenster Eigenschappenpagina's de knop OK om de wijzigingen in het project op te slaan.

6. U kunt nu de Arithmetic klasse in deze app gebruiken door de #include "MathLibrary.h" header in uw code op te slaan. Vervang de inhoud van MathClient.cpp met deze code:

   // 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. Als u het uitvoerbare bestand wilt bouwen, kiest u Build Solution> op de menubalk.

De app uitvoeren

De app uitvoeren:

1. Zorg ervoor dat MathClient is geselecteerd als het standaardproject. Als u dit wilt selecteren, klikt u met de rechtermuisknop op MathClient in Solution Explorer om het contextmenu te openen en kiest u Instellen als opstartbewerking Project.

2. Kies in de menubalk de optie Foutopsporing>starten zonder foutopsporing om het project uit te voeren. De uitvoer moet er ongeveer als volgt uitzien:

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

Zie ook

Overzicht: Een dynamische koppelingsbibliotheek maken en gebruiken (C++)