diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml index dc2f32815..91d934c41 100644 --- a/dev/pkgdown.yml +++ b/dev/pkgdown.yml @@ -8,7 +8,7 @@ articles: openxlsx2_charts_manual: openxlsx2_charts_manual.html openxlsx2_formulas_manual: openxlsx2_formulas_manual.html openxlsx2_style_manual: openxlsx2_style_manual.html -last_built: 2024-02-11T13:42Z +last_built: 2024-02-11T20:47Z urls: reference: https://janmarvin.github.io/openxlsx2/reference article: https://janmarvin.github.io/openxlsx2/articles diff --git a/dev/reference/properties-wb.html b/dev/reference/properties-wb.html index d9f956061..0c09f00dd 100644 --- a/dev/reference/properties-wb.html +++ b/dev/reference/properties-wb.html @@ -147,7 +147,7 @@
read_xlsx()
. This is because only the formula is written
and left to Excel to evaluate the formula when the file is opened in Excel.
The string "_openxlsx_NA"
is reserved for openxlsx2
.
-If the data frame contains this string, the output will be broken.
-Many base classes are covered, though not all and far from all third-party classes.
+If the data frame contains this string, the output will be broken.
+Supported classes are data frames, matrices and vectors of various types and
+everything that can be converted into a data frame with as.data.frame()
.
+Everything else that the user wants to write should either be converted into
+a vector or data frame or written in vector or data frame segments. This
+includes base classes such as table
, which were coerced internally in the
+predecessor of this package.
Even vectors and data frames can consist of different classes. Many base
+classes are covered, though not all and far from all third-party classes.
When data of an unknown class is written, it is handled with as.character()
.
It is not possible to write character nodes beginning with <r>
or <r/>
. Both
are reserved for internal functions. If you need these. You have to wrap
the input string in fmt_txt()
.
The columns of x
with class Date/POSIXt, currency, accounting, hyperlink,
+percentage are automatically styled as dates, currency, accounting,
+hyperlinks, percentages respectively.
Functions wb_add_data()
and wb_add_data_table()
behave quite similar. The
+distinction is that the latter creates a table in the worksheet that can be
+used for different kind of formulas and can be sorted independently, though
+is less flexible than basic cell regions.
The columns of x
with class Date/POSIXt, currency, accounting, hyperlink,
-percentage are automatically styled as dates, currency, accounting, hyperlinks,
-percentages respectively.
The string "_openxlsx_NA"
is reserved for openxlsx2
. If x
contains this
-string, the output will be broken.
Formulae written using wb_add_formula()
to a Workbook object will
+not get picked up by read_xlsx()
. This is because only the formula is written
+and left to Excel to evaluate the formula when the file is opened in Excel.
+The string "_openxlsx_NA"
is reserved for openxlsx2
.
+If the data frame contains this string, the output will be broken.
Supported classes are data frames, matrices and vectors of various types and
+everything that can be converted into a data frame with as.data.frame()
.
+Everything else that the user wants to write should either be converted into
+a vector or data frame or written in vector or data frame segments. This
+includes base classes such as table
, which were coerced internally in the
+predecessor of this package.
Even vectors and data frames can consist of different classes. Many base
+classes are covered, though not all and far from all third-party classes.
+When data of an unknown class is written, it is handled with as.character()
.
+It is not possible to write character nodes beginning with <r>
or <r/>
. Both
+are reserved for internal functions. If you need these. You have to wrap
+the input string in fmt_txt()
.
The columns of x
with class Date/POSIXt, currency, accounting, hyperlink,
+percentage are automatically styled as dates, currency, accounting,
+hyperlinks, percentages respectively.
Functions wb_add_data()
and wb_add_data_table()
behave quite similar. The
+distinction is that the latter creates a table in the worksheet that can be
+used for different kind of formulas and can be sorted independently, though
+is less flexible than basic cell regions.
The columns of x
with class Date/POSIXt, currency, accounting, hyperlink,
-percentage are automatically styled as dates, currency, accounting, hyperlinks,
-percentages respectively.
The string "_openxlsx_NA"
is reserved for openxlsx2
. If x
contains this
-string, the output will be broken.
Formulae written using wb_add_formula()
to a Workbook object will
+not get picked up by read_xlsx()
. This is because only the formula is written
+and left to Excel to evaluate the formula when the file is opened in Excel.
+The string "_openxlsx_NA"
is reserved for openxlsx2
.
+If the data frame contains this string, the output will be broken.
Supported classes are data frames, matrices and vectors of various types and
+everything that can be converted into a data frame with as.data.frame()
.
+Everything else that the user wants to write should either be converted into
+a vector or data frame or written in vector or data frame segments. This
+includes base classes such as table
, which were coerced internally in the
+predecessor of this package.
Even vectors and data frames can consist of different classes. Many base
+classes are covered, though not all and far from all third-party classes.
+When data of an unknown class is written, it is handled with as.character()
.
+It is not possible to write character nodes beginning with <r>
or <r/>
. Both
+are reserved for internal functions. If you need these. You have to wrap
+the input string in fmt_txt()
.
The columns of x
with class Date/POSIXt, currency, accounting, hyperlink,
+percentage are automatically styled as dates, currency, accounting,
+hyperlinks, percentages respectively.
Functions wb_add_data()
and wb_add_data_table()
behave quite similar. The
+distinction is that the latter creates a table in the worksheet that can be
+used for different kind of formulas and can be sorted independently, though
+is less flexible than basic cell regions.