mirror of https://github.com/tfussell/xlnt
Thomas Fussell
GitHub
commit
e043aeaff7
|
|
@ -1 +1,131 @@
|
|||
## Examples
|
||||
## Examples
|
||||
### Simple - reading from an existing xlsx spread sheet.
|
||||
The following C plus plus code will read the values from an xlsx file and print the string values to the screen. This is a very simple example to get you started.
|
||||
|
||||
```
|
||||
#include <iostream>
|
||||
#include <xlnt/xlnt.hpp>
|
||||
|
||||
int main()
|
||||
{
|
||||
xlnt::workbook wb;
|
||||
wb.load("/home/timothymccallum/test.xlsx");
|
||||
auto ws = wb.active_sheet();
|
||||
std::clog << "Processing spread sheet" << std::endl;
|
||||
for (auto row : ws.rows(false))
|
||||
{
|
||||
for (auto cell : row)
|
||||
{
|
||||
std::clog << cell.to_string() << std::endl;
|
||||
}
|
||||
}
|
||||
std::clog << "Processing complete" << std::endl;
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
Save the contents of the above file
|
||||
```
|
||||
/home/timothymccallum/process.cpp
|
||||
```
|
||||
Compile by typing the following command
|
||||
```
|
||||
g++ -std=c++14 -lxlnt process.cpp -o process
|
||||
```
|
||||
Excecute by typing the following command
|
||||
```
|
||||
./process
|
||||
```
|
||||
The output of the program, in my case, is as follows
|
||||
```
|
||||
Processing spread sheet
|
||||
This is cell A1.
|
||||
This is cell B1
|
||||
… and this is cell C1
|
||||
We are now on the second row at cell A2
|
||||
B2
|
||||
C2
|
||||
Processing complete
|
||||
```
|
||||
As you can see the process.cpp file simply walks through the spread sheet values row by row and column by column (A1, B1, C1, A2, B2, C2 and so on).
|
||||
|
||||
### Simple - storing a spread sheet in a 2 dimensional C++ Vector for further processing
|
||||
Loading a spread sheet into a Vector provides oppourtunities for you to perform high performance processing. There will be more examples on performing fast look-ups, merging data, performing deduplication and more. For now, let's just learn how to get the spread sheet loaded into memory.
|
||||
```
|
||||
#include <iostream>
|
||||
#include <xlnt/xlnt.hpp>
|
||||
#include <vector>
|
||||
|
||||
int main()
|
||||
{
|
||||
xlnt::workbook wb;
|
||||
wb.load("/home/timothymccallum/test.xlsx");
|
||||
auto ws = wb.active_sheet();
|
||||
std::clog << "Processing spread sheet" << std::endl;
|
||||
std::clog << "Creating a single vector which stores the whole spread sheet" << std::endl;
|
||||
std::vector< std::vector<std::string> > theWholeSpreadSheet;
|
||||
for (auto row : ws.rows(false))
|
||||
{
|
||||
std::clog << "Creating a fresh vector for just this row in the spread sheet" << std::endl;
|
||||
std::vector<std::string> aSingleRow;
|
||||
for (auto cell : row)
|
||||
{
|
||||
std::clog << "Adding this cell to the row" << std::endl;
|
||||
aSingleRow.push_back(cell.to_string());
|
||||
}
|
||||
std::clog << "Adding this entire row to the vector which stores the whole spread sheet" << std::endl;
|
||||
theWholeSpreadSheet.push_back(aSingleRow);
|
||||
}
|
||||
std::clog << "Processing complete" << std::endl;
|
||||
std::clog << "Reading the vector and printing output to the screen" << std::endl;
|
||||
for (int rowInt = 0; rowInt < theWholeSpreadSheet.size(); rowInt++)
|
||||
{
|
||||
for (int colInt = 0; colInt < theWholeSpreadSheet.at(rowInt).size(); colInt++)
|
||||
{
|
||||
std::cout << theWholeSpreadSheet.at(rowInt).at(colInt) << std::endl;
|
||||
}
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
Save the contents of the above file
|
||||
```
|
||||
/home/timothymccallum/process.cpp
|
||||
```
|
||||
Compile by typing the following command
|
||||
```
|
||||
g++ -std=c++14 -lxlnt process.cpp -o process
|
||||
```
|
||||
Excecute by typing the following command
|
||||
```
|
||||
./process
|
||||
```
|
||||
The output of the program, in my case, is as follows
|
||||
```
|
||||
Processing spread sheet
|
||||
Creating a single vector which stores the whole spread sheet
|
||||
Creating a fresh vector for just this row in the spread sheet
|
||||
Adding this cell to the row
|
||||
Adding this cell to the row
|
||||
Adding this cell to the row
|
||||
Adding this entire row to the vector which stores the whole spread sheet
|
||||
Creating a fresh vector for just this row in the spread sheet
|
||||
Adding this cell to the row
|
||||
Adding this cell to the row
|
||||
Adding this cell to the row
|
||||
Adding this entire row to the vector which stores the whole spread sheet
|
||||
Processing complete
|
||||
Reading the vector and printing output to the screen
|
||||
This is cell A1.
|
||||
This is cell B1
|
||||
… and this is cell C1
|
||||
We are now on the second row at cell A2
|
||||
B2
|
||||
C2
|
||||
```
|
||||
You will have noticed that this process is very fast. If you type the "time" as shown below, you can measure just how fast loading and retrieving your spread sheet is, using xlnt; In this case only a fraction of a second. More on this later.
|
||||
```
|
||||
time ./process
|
||||
...
|
||||
real 0m0.044s
|
||||
```
|
||||
### Simple - writing values to a new xlsx spread sheet.
|
||||
|
|
|
|||
|
|
@ -8,6 +8,59 @@
|
|||
|
||||
## vcpkg
|
||||
|
||||
## Compiling from Source - Ubuntu 16.04 LTS (Xenial Xerus)
|
||||
Please run the following commands and read the comments as you go.
|
||||
You will notice that we update and upgrade quite frequently, this is to ensure that all dependancies are met at all times. You will also notice that we are installing some libraries from source, there are two reasons for this; firstly in the event that the library is not available through apt-get or secondly, because we want the very latest version (not the version available in apt-get).
|
||||
```
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
sudo apt-get install cmake
|
||||
sudo apt-get install zlibc
|
||||
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
|
||||
sudo apt update
|
||||
sudo apt-get upgrade
|
||||
sudo apt-get install gcc-6 g++-6
|
||||
sudo apt update
|
||||
sudo apt-get upgrade
|
||||
```
|
||||
The following steps will set up some environment variables for this session
|
||||
```
|
||||
export CC=/usr/bin/gcc-6
|
||||
export CXX=/usr/bin/g++-6
|
||||
```
|
||||
The following steps will install the latest GCC compiler from source (you will notice that we installed GCC 6 using apt-get, this was a building block to the next step of getting GCC 6.3.0 - the latest compiler available at present).
|
||||
Download gcc 6.3.0 from https://gcc.gnu.org/mirrors.html I used the Japanese mirror as this is the closest location to me http://ftp.tsukuba.wide.ad.jp/software/gcc/releases/gcc-6.3.0/gcc-6.3.0.tar.gz
|
||||
|
||||
```
|
||||
cd ~
|
||||
tar -zxvf Downloads/gcc-6.3.0.tar.gz
|
||||
cd gcc-6.3.0
|
||||
./contrib/download_prerequisites
|
||||
mkdir build
|
||||
cd build
|
||||
../configure --disable-multilib --enable-languages=c,c++
|
||||
make -j 2
|
||||
sudo make install
|
||||
```
|
||||
If the above make command fails please use "make clean pristine" and then remove and remake the build directory. This will clean up and prepare the environment for another attempt. A common reason for failure on virtual machines is lack of RAM (if you don't have enough RAM you may get an error like this "recipe for target 's-attrtab' failed"). Otherwise, if all goes well in about 30 to 60 minutes the compiler will be ready and we will move on to the next steps.
|
||||
|
||||
The following steps will intall xlnt
|
||||
Download the zip file from the xlnt repository
|
||||
https://github.com/tfussell/xlnt/archive/master.zip
|
||||
```
|
||||
cd ~
|
||||
unzip Downloads/xlnt-master.zip
|
||||
cd xlnt-master
|
||||
cmake .
|
||||
make -j 2
|
||||
sudo make install
|
||||
```
|
||||
The following step will map the shared library names to the location of the corresponding shared library files
|
||||
```
|
||||
sudo ldconfig
|
||||
```
|
||||
xlnt will now be ready to use on your Ubuntu instance.
|
||||
|
||||
## Compiling from Source
|
||||
|
||||
Build configurations for Visual Studio, GNU Make, Ninja, and Xcode can be created using [cmake](https://cmake.org/) v3.2+. A full list of cmake generators can be found [here](https://cmake.org/cmake/help/v3.0/manual/cmake-generators.7.html). A basic build would look like (starting in the root xlnt directory):
|
||||
|
|
|
|||
Loading…
Reference in New Issue