NEWS.md
mform_handle_newlines that caused string matrix column names to be removed. This prevented paginated listing key column info from being repeated when vertically spanning multiple pages.paginate argument in the export_as_rtf function.round_type argument to indicate IEC (default) or SAS (nearest value, 5 goes up) rounding to all formatting machinery.mf_update_cinfo causing an error when export_as_txt was applied to empty listings.mform_handle_newlines that did not allow printing to console a table that has top left information, new lines in the column names and contained only one row.mform_handle_newlines that did not allow for empty strings to be present in top left information.format_value that caused multiple NA values to be associated with the wrong na_str values.lifecycle badge files for documentation.width, height and fontsize arguments of export_as_pdf() using lifecycle package.\r recursive special character.rlistings’ pagination by removing the manual subsetting workaround and fixing insightsengineering/rlistings#155.max_width. Introduced general handler .handle_max_width for pagination, exports, and toString.format_value causing a warning for vectors containing both NA and non-NA values.var_label assignment that needed to be of non-named strings.LabelRow assignment in basic_matrix_form.rtables’ matrix_form to formatters’ constructor MatrixPrintForm so to cover also rlistings.export_as_txt to allow lists of tables/listings as input. This enables listing pagination with pages by parameter.min_siblings > 0 when dealing with listings. This allows smooth pagination when there are only 2 lines.matrix_print_form constructor (now only MatrixPrintForm).styler and resolved package lint. Changed default indentation from 4 spaces to 2.set_default_hsep() that sets up the option getOption("formatters_default_hsep").export_as_pdf from rtables. Now using paginate_to_mpfs function. Made font_lcpi function internal.wrap_string that was caused by a bug in stringi::stri_wrap not wrapping small strings with dots and spaces correctly.paginate_to_mpfs() so that formatting in listings key columns is retained with pagination insightsengineering/rlistings#155.cpp or lpp is too small in comparison to the column or row widths.rtables objects.wrap_string so to allow space characters to be used and wrapped.paginate_to_mpfs can handle single column tables and listings.decimal, dec_right, and dec_left.export_as_txt to pass rep_cols argument to pagination function.list_valid_aligns() that lists the available alignments.na_str and align to NULL in the format configuration function fmt_config.prov_footer length is greater than 1 insightsengineering/rtables#705.export_as_txt to print split label when using page_by with only one level.getter and setter for align (obj_align and obj_align<-).fmt_config class to bundle together format, na_str, and align instructions.NULL to center) and na_str from NULL to "NA". This affects only rlistings, where the new default takes effect.MPF pagination (and thus export_as_txt) when column labels had newlines (#150, insightsengineering/rtables#634)font_size is now 8 consistently across the pagination machinery.verbose = TRUE).export_as_txt function operates now on any object with an applicable matrix_form method (including pagination).paginate_indices and paginate_to_mpfs functions.diagnose_pagination function accepts the same arguments as paginate_to_mpfs and returns information about the pagination algorithm outcome at both row and column positions.MatrixPrintForm objects now pay closer attention to referential footnote information than they did in the past.MatrixPrintForm objects infer detailed referential footnote information from their strings element for backward compatibility.lpp and cpp in pagination or exporter functions are assigned to NULL, no pagination in the vertical or horizontal direction happens, respectively.NA_integer_ for lpp and cpp now means those values should be inferred from page size.hexSticker logo.widths in toString and colwidths in pagination and exporters.getter and setter for na-string (obj_na_str and obj_na_str<-, migrated from rtables).MatrixPrintForm class now carries around has_topleft information explicitly, getter mf_has_topleft.MatrixPrintForm object (mf_nlheader) is now a computed attribute rather than a stored one, mf_nlheader<- has been removed.MatrixPrintForm accessor: mpf_has_rlabels determines whether the MPF$strings has a column which are label rows (i.e. no column index in originating object).wrap_text and wrap_string now accept the hard argument (default FALSE) indicating whether ‘hard’ word-wrapping (i.e. explicit embedding of newline characters) should be performed.vert_pag_indices now accepts rep_cols to control how many columns act as ‘row-label-like’, as required by rlistings.verbose = TRUE is now significantly more informative.mf_rinfo<- checked the new value against the wrong dimensions.mf_lgrouping non-functional has been fixed.nlines now accepts both colwidths and max_width, defaulting to NULL for bothpag_indices_inner, find_pag and valid_pag now accept have_col_fnotes and div_height argumentsinsightsengineering/rtables#414 (nlines("", <non-null>) threw an errornlines character method has changed, not takes the sum of the nlines of its elements instead of the max in the case of a vector of length > 1wrap_title_footer function for use on everything which implements the generic interface we design.page_dim function which returns values of page dims for a named type.tf_wrap functionality now breaks up words that are too large with respect to surrounding word wrapping.tf_wrap behavior no longer emits a warning when breaking up ‘words’ larger than max_width
tf_wrap max_width = "auto" now sets the max_width to sum(widths) + table_inset(x) instead of sum(widths)
tf_wrap functionality added to toString MatrixPrintForm methodMatrixPrintForm class now includes a table_inset elementtable_inset and table_inset<- generics now exportedtoString now respects table_inset values set on a MatrixPrintForm objectexact=TRUE for all calls to attr in accessor functions.na_str are now silently interpreted as the default value ("NA"), as are any missing values in na_str of length > 0.page_lcpp function now provided to map page size and font combinations to lines and characters per page.getters and setters for the components of MatrixPrintForm objects are now exported (i.e., mf_spans and friends).na_str can now be length >1, and is matched in position to NAs in that case.format_value now returns solely the na_str value when all-NA values are formatted with certain formats (currently"(N=xx)", ">999.9", ">999.99", "x.xxxx | (<0.0001)")label_vars<- now correctly adheres to names of value, even in different order than names(x). Fixes insightsengineering/rlistings#8
0.3.2.2 in vert_pag_indices when obj is not a MatrixPrintForm objecttrailing_sep column to row_info data.frames (e.g, pagdfrow constructor)trailing_sep info now used in both printing and paginationcol_gap is now an element of MatrixPrintForm objectsvert_pag_indices fixed to correctly take gap between printed columns into accountvar_labels on a data.frame with no columns is no longer an error (insightsengineering/rtables#224)default_hsep function for use her and in reverse-dependencies (incl rtables)na_str even when format is xx (previously it returned "NA" always)linesep argument to hsep in toString generic signatureindent_size argument to matrix_form generic signature"__ (__)" (no pct) formats in response to #23testthat as testing framework