QXlsx

Read this in other languages: English, 🇰🇷 한국어

• QXlsx is excel file(*.xlsx) reader/writer library.
  • Because QtXlsx is no longer supported(2014), I created a new project that is based on QtXlsx. (2017-)
  • Development language of QXlsx is C++. (with Qt 5.x)
  • You don't need to use static library or dynamic shared object using QXlsx.

License

• MIT License https://opensource.org/licenses/MIT
• QtXlsx License (See Debao Zhang (2014) site) https://github.com/dbzhang800/QtXlsxWriter
• Qt License (See Qt Company site) https://www.qt.io/

Sample (Hello excel)

1️⃣ Writing excel file(*.xlsx)

QXlsx::Document xlsx;
xlsx.write("A1", "Hello Qt!"); // write "Hello Qt!" to cell(A,1). it's shared string.
xlsx.saveAs("Test.xlsx"); // save the document as 'Test.xlsx'

2️⃣ Reading excel file(*.xlsx)

Document xlsx("Test.xlsx"); // load excel file
if (!xlsx.isLoadPackage()) { 
	return; // failed to load excel
}
int row = 1; int col = 2;
Cell* cell = xlsx.cellAt(row, col); // get cell pointer. (row is 1. column is 2.)
if ( cell == NULL )
	continue; // cell vaule is not set
QVariant var = cell->readValue(); // read cell value (number(double), QDateTime, QString ...)
qDebug() << var; // display value

How to set up

• See How to setup QXlsx project

Test environment

Test Environment is below.

• Qt 5.10.1 (MingW/Windows 32bit)
• Qt 5.9.2 (MingW/Windows 32bit)
• Qt 5.9.1 (Visual Studio 2017/Windows 64bit)
• Qt 5.9.1 (Visual Studio 2017/Windows 32bit)
• Qt 5.9.1 (MingW/Windows 32bit)
• Qt 5.9.1 (Ubuntu 16/Linux x64)
• Qt 5.6.0 (MingW/Windows 32bit)
• Qt 5.5.1 (MingW/Windows 32bit)
• Qt 5.5.0 (Ubuntu 17/Linux i686)
• Qt 5.2.0 (Ubuntu 14/Linux x64)
• Qt 5.0.1 (MingW/Windows 32bit)

To Test

• The following tests should be performed.
  • Microsoft Excel
  • Google Spreadsheet
  • LibreOffice Calc Spreasheet

• Unicode test ( ☁️ filename, ☁️ filepath, ☀️ data value)

To Upgrade

• Develop the encryption function of xlsx
• Build and test on Android

Contacts

• Leave me a issue. https://github.com/j2doll/QXlsx/issues
  • If you are interested in participating in the project, please contact us by issue.
• Hi! I'm j2doll (aka Jay Two). My name is Korean and it is difficult for foreigners to pronounce it. Call me j2doll.
• My native language is not English and my English is not fluent. Please, use EASY English. :-)

Similar projects I'm going on

• Qxlnt https://github.com/j2doll/Qxlnt.git
  • Qxlnt is a helper project that allows xlnt to be used in Qt.
  • xlnt is a excellent library for usinf xlsx Excel files.
  • I was looking for a way to make it easy to use in Qt. Of course, cmake is compatible with Qt, but it is not convenient to use. So I created Qxlnt.