https://github.com/kassane/zig-xlsxwriter

A Zig library for writing files in the Excel 2007+ XLSX file format
https://github.com/kassane/zig-xlsxwriter

bindings libxlsxwriter xlsx xlsxwriter zig

Last synced: 4 months ago
JSON representation

A Zig library for writing files in the Excel 2007+ XLSX file format

• Host: GitHub
• URL: https://github.com/kassane/zig-xlsxwriter
• Owner: kassane
• License: apache-2.0
• Created: 2022-11-26T14:06:06.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-12T13:32:52.000Z (5 months ago)
• Last Synced: 2024-10-05T15:58:19.513Z (4 months ago)
• Topics: bindings, libxlsxwriter, xlsx, xlsxwriter, zig
• Language: Zig
• Homepage:
• Size: 66.4 KB
• Stars: 11
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# zig-xlsxwriter

The `zig-xlsxwriter` is a wrapper of [`libxlsxwriter`](https://github.com/jmcnamara/libxlsxwriter) that can be used to write text, numbers,

dates and formulas to multiple worksheets in a new Excel 2007+ xlsx file. It

has a focus on performance and on fidelity with the file format created by

Excel. It cannot be used to modify an existing file.

## Requirements

- [zig v0.12.0 or higher](https://ziglang.org/download)

- [libxlsxwriter](https://github.com/jmcnamara/libxlsxwriter)

## Example

Sample code to generate the Excel file shown above.

```zig

const xlsxwriter = @import("xlsxwriter");

const Expense = struct {

    item: [*:0]const u8,

    cost: f64,

    datetime: xlsxwriter.lxw_datetime,

};

var expenses = [_]Expense{

    .{ .item = "Rent", .cost = 1000.0, .datetime = .{ .year = 2013, .month = 1, .day = 13, .hour = 8, .min = 34, .sec = 65.45 } },

    .{ .item = "Gas", .cost = 100.0, .datetime = .{ .year = 2013, .month = 1, .day = 14, .hour = 12, .min = 17, .sec = 23.34 } },

    .{ .item = "Food", .cost = 300.0, .datetime = .{ .year = 2013, .month = 1, .day = 16, .hour = 4, .min = 29, .sec = 54.05 } },

    .{ .item = "Gym", .cost = 50.0, .datetime = .{ .year = 2013, .month = 1, .day = 20, .hour = 6, .min = 55, .sec = 32.16 } },

};

pub fn main() void {

    // Create a workbook and add a worksheet.

    const workbook: ?*xlsxwriter.lxw_workbook = xlsxwriter.workbook_new("out/tutorial2.xlsx");

    const worksheet: ?*xlsxwriter.lxw_worksheet = xlsxwriter.workbook_add_worksheet(workbook, null);

    // Start from the first cell. Rows and columns are zero indexed.

    var row: u32 = 0;

    var col: u16 = 0;

    var index: usize = 0;

    // Add a bold format to use to highlight cells.

    const bold: ?*xlsxwriter.lxw_format = xlsxwriter.workbook_add_format(workbook);

    _ = xlsxwriter.format_set_bold(bold);

    // Add a number format for cells with money.

    const money: ?*xlsxwriter.lxw_format = xlsxwriter.workbook_add_format(workbook);

    _ = xlsxwriter.format_set_num_format(money, "$#,##0");

    // Add an Excel date format.

    const date_format: ?*xlsxwriter.lxw_format = xlsxwriter.workbook_add_format(workbook);

    _ = xlsxwriter.format_set_num_format(date_format, "mmmm d yyyy");

    // Adjust the column width.

    _ = xlsxwriter.worksheet_set_column(worksheet, 0, 0, 15, null);

    // Write some data header.

    _ = xlsxwriter.worksheet_write_string(worksheet, row, col, "Item", bold);

    _ = xlsxwriter.worksheet_write_string(worksheet, row, col + 1, "Cost", bold);

    // Iterate over the data and write it out element by element.

    while (row < 4) : (row += 1) {

        _ = xlsxwriter.worksheet_write_string(worksheet, row, col, expenses[index].item, null);

        _ = xlsxwriter.worksheet_write_datetime(worksheet, row, col + 1, &expenses[index].datetime, date_format);

        _ = xlsxwriter.worksheet_write_number(worksheet, row, col + 2, expenses[index].cost, money);

    }

    // Write a total using a formula.

    _ = xlsxwriter.worksheet_write_string(worksheet, row, col, "Total", 0);

    _ = xlsxwriter.worksheet_write_formula(worksheet, row + 1, col + 2, "=SUM(C2:C5)", null);

    // Save the workbook and free any allocated memory.

    _ = xlsxwriter.workbook_close(workbook);

}

```