https://github.com/tfussell/xlnt

:bar_chart: Cross-platform user-friendly xlsx library for C++11+
https://github.com/tfussell/xlnt

api c-plus-plus cpp excel microsoft read spreadsheet write xlsx

Last synced: 4 days ago
JSON representation

:bar_chart: Cross-platform user-friendly xlsx library for C++11+

• Host: GitHub
• URL: https://github.com/tfussell/xlnt
• Owner: tfussell
• License: other
• Created: 2014-05-06T16:58:23.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-08-16T10:16:41.000Z (5 months ago)
• Last Synced: 2025-01-01T20:05:18.327Z (11 days ago)
• Topics: api, c-plus-plus, cpp, excel, microsoft, read, spreadsheet, write, xlsx
• Language: C++
• Homepage:
• Size: 15 MB
• Stars: 1,509
• Watchers: 78
• Forks: 423
• Open Issues: 206
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Authors: AUTHORS.md

Awesome Lists containing this project

• AwesomeCppGameDev - xlnt - platform user-friendly xlsx library for C++14 (C++)

README

        



====

[![Travis Build Status](https://travis-ci.org/tfussell/xlnt.svg?branch=master)](https://travis-ci.org/tfussell/xlnt)

[![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/2hs79a1xoxy16sol?svg=true)](https://ci.appveyor.com/project/tfussell/xlnt)

[![Coverage Status](https://coveralls.io/repos/github/tfussell/xlnt/badge.svg?branch=master)](https://coveralls.io/github/tfussell/xlnt?branch=master)

[![Documentation Status](https://legacy.gitbook.com/button/status/book/tfussell/xlnt)](https://tfussell.gitbooks.io/xlnt/content/)

[![License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](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 

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.