mirror of
https://github.com/tfussell/xlnt.git
synced 2024-03-22 13:11:17 +08:00
53 lines
3.0 KiB
Markdown
53 lines
3.0 KiB
Markdown
<img height="100" src="https://user-images.githubusercontent.com/1735211/29433390-f37fa28e-836c-11e7-8a60-f8df4c30b424.png" alt="xlnt logo"><br/>
|
|
====
|
|
|
|
[](https://travis-ci.org/tfussell/xlnt)
|
|
[](https://ci.appveyor.com/project/tfussell/xlnt)
|
|
[](https://coveralls.io/github/tfussell/xlnt?branch=master)
|
|
[](https://tfussell.gitbooks.io/xlnt/content/)
|
|
[](http://opensource.org/licenses/MIT)
|
|
|
|
## Introduction
|
|
xlnt is a modern C++ library for manipulating spreadsheets in memory and reading/writing them from/to XLSX files as described in [ECMA 376 4th edition](http://www.ecma-international.org/publications/standards/Ecma-376.htm). The first public release of xlnt version 1.0 was on May 10th, 2017. Current work is focused on increasing compatibility, improving performance, and brainstorming future development goals. For a high-level summary of what you can do with this library, see [the feature list](https://tfussell.gitbooks.io/xlnt/content/docs/introduction/Features.html). Contributions are welcome in the form of pull requests or discussions on [the repository's Issues page](https://github.com/tfussell/xlnt/issues).
|
|
|
|
## Example
|
|
|
|
Including xlnt in your project, creating a new spreadsheet, and saving it as "example.xlsx"
|
|
|
|
```c++
|
|
#include <xlnt/xlnt.hpp>
|
|
|
|
int main()
|
|
{
|
|
xlnt::workbook wb;
|
|
xlnt::worksheet ws = wb.active_sheet();
|
|
ws.cell("A1").value(5);
|
|
ws.cell("B2").value("string data");
|
|
ws.cell("C3").formula("=RAND()");
|
|
ws.merge_cells("C3:C4");
|
|
ws.freeze_panes("B2");
|
|
wb.save("example.xlsx");
|
|
return 0;
|
|
}
|
|
// compile with -std=c++14 -Ixlnt/include -lxlnt
|
|
```
|
|
|
|
## Documentation
|
|
|
|
Documentation for the current release of xlnt is available [here](https://tfussell.gitbooks.io/xlnt/content/).
|
|
|
|
## Building xlnt - Using vcpkg
|
|
|
|
You can download and install xlnt using the [vcpkg](https://github.com/microsoft/vcpkg) dependency manager:
|
|
|
|
git clone https://github.com/microsoft/vcpkg.git
|
|
cd vcpkg
|
|
./bootstrap-vcpkg.sh
|
|
./vcpkg integrate install
|
|
./vcpkg install xlnt
|
|
|
|
The xlnt port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/microsoft/vcpkg) on the vcpkg repository.
|
|
|
|
## License
|
|
xlnt is released to the public for free under the terms of the MIT License. See [LICENSE.md](https://github.com/tfussell/xlnt/blob/master/LICENSE.md) for the full text of the license and the licenses of xlnt's third-party dependencies. [LICENSE.md](https://github.com/tfussell/xlnt/blob/master/LICENSE.md) should be distributed alongside any assemblies that use xlnt in source or compiled form.
|