This is a C++ library for parsing, writing and manipulating vCards. Inspired by libvcard 1.0.0 and ez-vcard
- vCard depends on having the
2.xbranch of Catch2 installed as the unit tests depend on the cmake files that are installed with it.
mkdir build
cd build
cmake ..
make
sudo make install
Reading text .vcf file:
#include "vcard.h"
#include "text_io.h"
...
std::ifstream ifs;
ifs.open("test.vcf");
TextReader tr(ifs);
std::vector<vCard> cards = tr.parseCards();
Creating vCard objects and write it to string buffer (or it can be file stream):
vCardParamMap params;
params.addParam("TYPE", "home");
params.addParam("TYPE", "work");
params.addParam("LANGUAGE", "en");
vCardProperty p = vCardProperty::createAddress("Street", "City", "Nevada", "112233", "USA");
p << params;
vCard card;
card << p;
std::stringstream s;
TextWriter tw(s);
tw << card;More writers and readers will be added soon (for xCards and jCards formats)
For more examples check test/tests.cpp file
After building the app using the steps above, you can run all the unit tests by calling make test inside the build directory.
To rerun one particular test with all debug information, use ctest -R [NAME OF TEST] -VV where [NAME OF TEST] is where you put the name of the unit test you want to run, such as vCard_test:vCard. See https://stackoverflow.com/a/6933301/ for more information.
In general these test names will be of the format vCard_test: followed by the name of the test as defined in tests.cpp.
vCard is licensed under the GNU General Public License v3.0 or later.