// Copyright (c) 2014-2021 Thomas Fussell // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE // // @license: http://www.opensource.org/licenses/mit-license.php // @author: see AUTHORS file #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include class cell_test_suite : public test_suite { public: cell_test_suite() { register_test(test_infer_numeric); register_test(test_constructor); register_test(test_null); register_test(test_string); register_test(test_formula1); register_test(test_formula2); register_test(test_formula3); register_test(test_not_formula); register_test(test_boolean); register_test(test_error_codes); register_test(test_insert_datetime); register_test(test_insert_date); register_test(test_insert_time); register_test(test_cell_formatted_as_date1); register_test(test_cell_formatted_as_date2); register_test(test_cell_formatted_as_date3); register_test(test_illegal_characters); register_test(test_timedelta); register_test(test_cell_offset); register_test(test_font); register_test(test_fill); register_test(test_border); register_test(test_number_format); register_test(test_alignment); register_test(test_protection); register_test(test_style); register_test(test_print); register_test(test_values); register_test(test_reference); register_test(test_anchor); register_test(test_hyperlink); register_test(test_comment); register_test(test_copy_and_compare); register_test(test_cell_phonetic_properties); } private: void test_infer_numeric() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); cell.value("4.2", true); xlnt_assert_delta(cell.value(), 4.2, 1E-9); cell.value("-42.000", true); xlnt_assert(cell.value() == -42); cell.value("0", true); xlnt_assert(cell.value() == 0); cell.value("0.9999", true); xlnt_assert(cell.value() == 0.9999); cell.value("99E-02", true); xlnt_assert(cell.value() == 0.99); cell.value("4", true); xlnt_assert(cell.value() == 4); cell.value("-1E3", true); xlnt_assert(cell.value() == -1000); cell.value("2e+2", true); xlnt_assert(cell.value() == 200); cell.value("3.1%", true); xlnt_assert_delta(cell.value(), 0.031, 1E-9); cell.value("03:40:16", true); xlnt_assert(cell.value() == xlnt::time(3, 40, 16)); cell.value("03:", true); xlnt_assert_equals(cell.value(), "03:"); cell.value("03:40", true); xlnt_assert(cell.value() == xlnt::time(3, 40)); cell.value("30:33.865633336", true); xlnt_assert(cell.value() == xlnt::time(0, 30, 33, 865633)); } void test_constructor() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference("A", 1)); xlnt_assert(cell.data_type() == xlnt::cell::type::empty); xlnt_assert(cell.column() == "A"); xlnt_assert(cell.column_index() == 1); xlnt_assert(cell.row() == 1); xlnt_assert(cell.reference() == "A1"); xlnt_assert(!cell.has_value()); } void test_null() { xlnt::workbook wb; const auto datatypes = { xlnt::cell::type::empty, xlnt::cell::type::boolean, xlnt::cell::type::error, xlnt::cell::type::formula_string, xlnt::cell::type::number, xlnt::cell::type::shared_string}; for (const auto &datatype : datatypes) { auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.data_type(datatype); xlnt_assert(cell.data_type() == datatype); cell.clear_value(); xlnt_assert(cell.data_type() == xlnt::cell::type::empty); } } void test_string() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value("hello"); xlnt_assert(cell.data_type() == xlnt::cell::type::shared_string); cell.value("."); xlnt_assert(cell.data_type() == xlnt::cell::type::shared_string); cell.value("0800"); xlnt_assert(cell.data_type() == xlnt::cell::type::shared_string); } void test_formula1() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value("=42", true); //xlnt_assert(cell.data_type() == xlnt::cell::type::number); xlnt_assert(cell.has_formula()); } void test_formula2() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value("=if(A1<4;-1;1)", true); //xlnt_assert(cell.data_type() == xlnt::cell::type::number); xlnt_assert(cell.has_formula()); } void test_formula3() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); xlnt_assert(!cell.has_formula()); xlnt_assert_throws_nothing(cell.formula("")); xlnt_assert(!cell.has_formula()); cell.formula("=42"); xlnt_assert(cell.has_formula()); xlnt_assert_equals(cell.formula(), "42"); cell.clear_formula(); xlnt_assert(!cell.has_formula()); } void test_not_formula() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value("=", true); xlnt_assert(cell.data_type() == xlnt::cell::type::shared_string); xlnt_assert(cell.value() == "="); xlnt_assert(!cell.has_formula()); } void test_boolean() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); for (auto value : {true, false}) { cell.value(value); xlnt_assert(cell.data_type() == xlnt::cell::type::boolean); } } void test_error_codes() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); // error string can't be empty xlnt_assert_throws(cell.error(""), xlnt::exception); // error string has to have a leading '#' xlnt_assert_throws(cell.error("not an error"), xlnt::exception); for (auto error_code : xlnt::cell::error_codes()) { // error type from the string format cell.value(error_code.first, true); xlnt_assert(cell.data_type() == xlnt::cell::type::error); std::string error; xlnt_assert_throws_nothing(error = cell.error()); xlnt_assert_equals(error, error_code.first); // clearing the value clears the error state cell.clear_value(); xlnt_assert_throws(cell.error(), xlnt::exception); // can explicitly set the error xlnt_assert_throws_nothing(cell.error(error_code.first)); std::string error2; xlnt_assert_throws_nothing(error2 = cell.error()); xlnt_assert_equals(error2, error_code.first); } } void test_insert_datetime() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::datetime(2010, 7, 13, 6, 37, 41)); xlnt_assert(cell.data_type() == xlnt::cell::type::number); xlnt_assert_delta(cell.value(), 40372.27616898148, 1E-9); xlnt_assert(cell.is_date()); xlnt_assert(cell.number_format().format_string() == "yyyy-mm-dd h:mm:ss"); } void test_insert_date() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::date(2010, 7, 13)); xlnt_assert(cell.data_type() == xlnt::cell::type::number); xlnt_assert(cell.value() == 40372.0); xlnt_assert(cell.is_date()); xlnt_assert(cell.number_format().format_string() == "yyyy-mm-dd"); } void test_insert_time() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::time(1, 3)); xlnt_assert(cell.data_type() == xlnt::cell::type::number); xlnt_assert_delta(cell.value(), 0.04375, 1E-9); xlnt_assert(cell.is_date()); xlnt_assert(cell.number_format().format_string() == "h:mm:ss"); } void test_cell_formatted_as_date1() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::datetime::today()); cell.clear_value(); xlnt_assert(!cell.is_date()); // disagree with openpyxl xlnt_assert(!cell.has_value()); } void test_cell_formatted_as_date2() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::datetime::today()); cell.value("testme"); xlnt_assert(!cell.is_date()); xlnt_assert(cell.value() == "testme"); } void test_cell_formatted_as_date3() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::datetime::today()); cell.value(true); xlnt_assert(!cell.is_date()); xlnt_assert(cell.value() == true); } void test_illegal_characters() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); // The bytes 0x00 through 0x1F inclusive must be manually escaped in values. auto illegal_chrs = {0, 1, 2, 3, 4, 5, 6, 7, 8, 11, 12, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31}; for (auto i : illegal_chrs) { std::string str(1, i); xlnt_assert_throws(cell.value(str), xlnt::illegal_character); } cell.value(std::string(1, 33)); cell.value(std::string(1, 9)); // Tab cell.value(std::string(1, 10)); // Newline cell.value(std::string(1, 13)); // Carriage return cell.value(" Leading and trailing spaces are legal "); } // void test_time_regex() {} void test_timedelta() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); cell.value(xlnt::timedelta(1, 3, 0, 0, 0)); xlnt_assert(cell.value() == 1.125); xlnt_assert(cell.data_type() == xlnt::cell::type::number); xlnt_assert(!cell.is_date()); xlnt_assert(cell.number_format().format_string() == "[hh]:mm:ss"); } void test_cell_offset() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell(xlnt::cell_reference(1, 1)); xlnt_assert(cell.offset(1, 2).reference() == "B3"); } void test_font() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); auto font = xlnt::font().bold(true); cell.font(font); xlnt_assert(cell.has_format()); xlnt_assert(cell.format().font_applied()); xlnt_assert_equals(cell.font(), font); } void test_fill() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt::fill fill(xlnt::pattern_fill() .type(xlnt::pattern_fill_type::solid) .foreground(xlnt::color::red())); cell.fill(fill); xlnt_assert(cell.has_format()); xlnt_assert(cell.format().fill_applied()); xlnt_assert_equals(cell.fill(), fill); } void test_border() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt::border border; cell.border(border); xlnt_assert(cell.has_format()); xlnt_assert(cell.format().border_applied()); xlnt_assert_equals(cell.border(), border); } void test_number_format() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt::number_format format("dd--hh--mm"); cell.number_format(format); xlnt_assert(cell.has_format()); xlnt_assert(cell.format().number_format_applied()); xlnt_assert_equals(cell.number_format().format_string(), "dd--hh--mm"); } void test_alignment() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt::alignment align; align.wrap(true); cell.alignment(align); xlnt_assert(cell.has_format()); xlnt_assert(cell.format().alignment_applied()); xlnt_assert_equals(cell.alignment(), align); } void test_protection() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt_assert(!cell.has_format()); auto protection = xlnt::protection().locked(false).hidden(true); cell.protection(protection); xlnt_assert(cell.has_format()); xlnt_assert(cell.format().protection_applied()); xlnt_assert_equals(cell.protection(), protection); xlnt_assert(cell.has_format()); cell.clear_format(); xlnt_assert(!cell.has_format()); } void test_style() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt_assert(!cell.has_style()); auto test_style = wb.create_style("test_style"); test_style.number_format(xlnt::number_format::date_ddmmyyyy(), true); cell.style(test_style); xlnt_assert(cell.has_style()); xlnt_assert_equals(cell.style().number_format(), xlnt::number_format::date_ddmmyyyy()); xlnt_assert_equals(cell.style(), test_style); auto other_style = wb.create_style("other_style"); other_style.number_format(xlnt::number_format::date_time2(), true); cell.style("other_style"); xlnt_assert_equals(cell.style().number_format(), xlnt::number_format::date_time2()); xlnt_assert_equals(cell.style(), other_style); auto last_style = wb.create_style("last_style"); last_style.number_format(xlnt::number_format::percentage(), true); cell.style(last_style); xlnt_assert_equals(cell.style().number_format(), xlnt::number_format::percentage()); xlnt_assert_equals(cell.style(), last_style); xlnt_assert_throws(cell.style("doesn't exist"), xlnt::key_not_found); cell.clear_style(); xlnt_assert(!cell.has_style()); xlnt_assert_throws(cell.style(), xlnt::invalid_attribute); } void test_print() { xlnt::workbook wb; auto ws = wb.active_sheet(); { auto cell = ws.cell("A1"); std::stringstream ss; ss << cell; auto stream_string = ss.str(); xlnt_assert_equals(cell.to_string(), stream_string); xlnt_assert_equals(stream_string, ""); } { auto cell = ws.cell("A2"); cell.value(false); std::stringstream ss; ss << cell; auto stream_string = ss.str(); xlnt_assert_equals(cell.to_string(), stream_string); xlnt_assert_equals(stream_string, "FALSE"); } { auto cell = ws.cell("A3"); cell.value(true); std::stringstream ss; ss << cell; auto stream_string = ss.str(); xlnt_assert_equals(cell.to_string(), stream_string); xlnt_assert_equals(stream_string, "TRUE"); } { auto cell = ws.cell("A4"); cell.value(1.234); std::stringstream ss; ss << cell; auto stream_string = ss.str(); xlnt_assert_equals(cell.to_string(), stream_string); xlnt_assert_equals(stream_string, "1.234"); } { auto cell = ws.cell("A5"); cell.error("#REF"); std::stringstream ss; ss << cell; auto stream_string = ss.str(); xlnt_assert_equals(cell.to_string(), stream_string); xlnt_assert_equals(stream_string, "#REF"); } { auto cell = ws.cell("A6"); cell.value("test"); std::stringstream ss; ss << cell; auto stream_string = ss.str(); xlnt_assert_equals(cell.to_string(), stream_string); xlnt_assert_equals(stream_string, "test"); } } void test_values() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); cell.value(static_cast(4)); xlnt_assert_equals(cell.value(), 4); cell.value(static_cast(3)); xlnt_assert_equals(cell.value(), 3); cell.value(static_cast(4)); xlnt_assert_equals(cell.value(), 4); cell.value(static_cast(3)); xlnt_assert_equals(cell.value(), 3); cell.value(static_cast(3.14)); xlnt_assert_delta(cell.value(), 3.14, 0.001); cell.value(static_cast(3.141592)); xlnt_assert_equals(cell.value(), 3.141592); auto cell2 = ws.cell("A2"); cell2.value(std::string(100000, 'a')); cell.value(cell2); xlnt_assert_equals(cell.value(), std::string(32767, 'a')); } void test_reference() { xlnt::cell_reference_hash hash; xlnt_assert_differs(hash(xlnt::cell_reference("A2")), hash(xlnt::cell_reference(1, 1))); xlnt_assert_equals(hash(xlnt::cell_reference("A2")), hash(xlnt::cell_reference(1, 2))); xlnt_assert_equals((xlnt::cell_reference("A1"), xlnt::cell_reference("B2")), xlnt::range_reference("A1:B2")); xlnt_assert_throws(xlnt::cell_reference("A1&"), xlnt::invalid_cell_reference); xlnt_assert_throws(xlnt::cell_reference("A"), xlnt::invalid_cell_reference); auto ref = xlnt::cell_reference("$B$7"); xlnt_assert_equals(ref.row_absolute(), true); xlnt_assert_equals(ref.column_absolute(), true); ref = xlnt::cell_reference("$B7"); xlnt_assert_equals(ref.row_absolute(), false); xlnt_assert_equals(ref.column_absolute(), true); ref = xlnt::cell_reference("B$7"); xlnt_assert_equals(ref.row_absolute(), true); xlnt_assert_equals(ref.column_absolute(), false); xlnt_assert(xlnt::cell_reference("A1") == "A1"); xlnt_assert(xlnt::cell_reference("A1") != "A2"); } void test_anchor() { xlnt::workbook wb; auto cell = wb.active_sheet().cell("A1"); auto anchor = cell.anchor(); xlnt_assert_equals(anchor.first, 0); xlnt_assert_equals(anchor.second, 0); } void test_hyperlink() { xlnt::workbook wb; auto cell = wb.active_sheet().cell("A1"); xlnt_assert(!cell.has_hyperlink()); xlnt_assert_throws(cell.hyperlink(), xlnt::invalid_attribute); xlnt_assert_throws(cell.hyperlink(""), xlnt::invalid_parameter); // link without optional display const std::string link1("http://example.com"); cell.hyperlink(link1); xlnt_assert(cell.has_hyperlink()); xlnt_assert(cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().url(), link1); xlnt_assert_equals(cell.hyperlink().relationship().target().to_string(), link1); xlnt_assert_equals(cell.hyperlink().display(), link1); cell.clear_value(); // link with display const std::string link2("http://example2.com"); const std::string display_txt("notaurl"); cell.hyperlink(link2, display_txt); xlnt_assert(cell.has_hyperlink()); xlnt_assert(cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().url(), link2); xlnt_assert_equals(cell.hyperlink().relationship().target().to_string(), link2); xlnt_assert_equals(cell.hyperlink().display(), display_txt); // relative (local) url const std::string local("../test_local"); cell.hyperlink(local); xlnt_assert(cell.has_hyperlink()); xlnt_assert(cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().url(), local); xlnt_assert_equals(cell.hyperlink().relationship().target().to_string(), local); // value int cell_test_val = 123; cell.value(cell_test_val); std::string cell_value_str = std::to_string(cell_test_val); cell.hyperlink(link2, display_txt); xlnt_assert_equals(cell.value(), 123); xlnt_assert_equals(cell.hyperlink().display(), cell_value_str); // display text ignored cell.clear_value(); // cell overload without display const std::string cell_target_str("A2"); auto cell_target = wb.active_sheet().cell(cell_target_str); std::string link3 = wb.active_sheet().title() + '!' + cell_target_str; // Sheet1!A2 cell.hyperlink(cell_target); xlnt_assert(cell.has_hyperlink()); xlnt_assert(!cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().target_range(), link3); xlnt_assert_equals(cell.hyperlink().display(), link3); cell.clear_value(); // cell overload with display cell.hyperlink(cell_target, display_txt); xlnt_assert(cell.has_hyperlink()); xlnt_assert(!cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().target_range(), link3); xlnt_assert_equals(cell.hyperlink().display(), display_txt); // value cell.value(cell_test_val); cell.hyperlink(cell_target, display_txt); xlnt_assert_equals(cell.value(), 123); xlnt_assert_equals(cell.hyperlink().display(), cell_value_str); // display text ignored cell.clear_value(); // range overload without display const std::string range_target_str("A2:A5"); xlnt::range range_target(wb.active_sheet(), xlnt::range_reference(range_target_str)); std::string link4 = wb.active_sheet().title() + '!' + range_target_str; // Sheet1!A2:A5 cell.hyperlink(range_target); xlnt_assert(cell.has_hyperlink()); xlnt_assert(!cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().target_range(), link4); xlnt_assert_equals(cell.hyperlink().display(), link4); cell.clear_value(); // range overload with display cell.hyperlink(range_target, display_txt); xlnt_assert(cell.has_hyperlink()); xlnt_assert(!cell.hyperlink().external()); xlnt_assert_equals(cell.hyperlink().target_range(), link4); xlnt_assert_equals(cell.hyperlink().display(), display_txt); // value cell.value(cell_test_val); cell.hyperlink(range_target, display_txt); xlnt_assert_equals(cell.value(), 123); xlnt_assert_equals(cell.hyperlink().display(), cell_value_str); // display text ignored cell.clear_value(); } void test_comment() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell = ws.cell("A1"); xlnt_assert(!cell.has_comment()); xlnt_assert_throws(cell.comment(), xlnt::exception); cell.comment(xlnt::comment("comment", "author")); xlnt_assert(cell.has_comment()); xlnt_assert_equals(cell.comment(), xlnt::comment("comment", "author")); cell.clear_comment(); xlnt_assert(!cell.has_comment()); xlnt_assert_throws(cell.comment(), xlnt::exception); xlnt::comment comment_with_size("test comment", "author"); comment_with_size.size(1000, 30); cell.comment(comment_with_size); xlnt_assert_equals(cell.comment(), comment_with_size); } void test_copy_and_compare() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell1 = ws.cell("A1"); auto cell2 = ws.cell("A2"); xlnt_assert_equals(cell1, cell1); xlnt_assert_equals(cell2, cell2); xlnt_assert_differs(cell1, cell2); xlnt_assert_differs(cell2, cell1); // nullptr equality xlnt_assert(nullptr == cell1); xlnt_assert(cell1 == nullptr); cell1.value("test"); xlnt_assert(!(nullptr == cell1)); xlnt_assert(!(cell1 == nullptr)); // copy xlnt::cell cell3(cell1); xlnt_assert_equals(cell1, cell3); // assign cell3 = cell2; xlnt_assert_equals(cell2, cell3); } void test_cell_phonetic_properties() { xlnt::workbook wb; auto ws = wb.active_sheet(); auto cell1 = ws.cell("A1"); xlnt_assert_equals(cell1.phonetics_visible(), false); cell1.show_phonetics(true); xlnt_assert_equals(cell1.phonetics_visible(), true); cell1.show_phonetics(false); xlnt_assert_equals(cell1.phonetics_visible(), false); } }; static cell_test_suite x{};