blob: a63a14f0d809a14268a7eb01e6be325a190c5a47 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
.. highlight:: cpp
Cell Access
===========
Examples
--------
You can obtain a :cpp:class:`~ixion::cell_access` instance either from
:cpp:class:`~ixion::model_context` or :cpp:class:`~ixion::document` class.
Here is an example of how to obtain it from a :cpp:class:`~ixion::model_context` instance::
ixion::model_context cxt;
cxt.append_sheet("Sheet");
// fill this model context
ixion::abs_address_t A1(0, 0, 0);
ixion::cell_access ca = cxt.get_cell_access(A1);
Here is an example of how to obtain it from a :cpp:class:`~ixion::document` instance::
ixion::document doc;
doc.append_sheet("Sheet");
// fill this document
ixion::cell_access ca = doc.get_cell_access("A1");
Once you have your :cpp:class:`~ixion::cell_access` instance, you can, for instance,
print the value of the cell as follows::
switch (ca.get_value_type())
{
case ixion::cell_value_t::numeric:
{
double v = ca.get_numeric_value();
cout << "numeric value: " << v << endl;
break;
}
case ixion::cell_value_t::string:
{
std::string_view s = ca.get_string_value();
cout << "string value: " << s << endl;
break;
}
case ixion::cell_value_t::boolean:
{
cout << "boolean value: " << ca.get_boolean_value() << endl;
break;
}
case ixion::cell_value_t::error:
{
ixion::formula_error_t err = ca.get_error_value();
cout << "error value: " << ixion::get_formula_error_name(err) << endl;
break;
}
case ixion::cell_value_t::empty:
{
cout << "empty cell" << endl;
break;
}
default:
cout << "???" << endl;
}
The complete source code of this example is avaiable
`here <https://gitlab.com/ixion/ixion/-/blob/master/doc_example/section_examples/cell_access.cpp>`_.
API Reference
-------------
.. doxygenclass:: ixion::cell_access
:members:
|
