This vignette shows how pagination can be applied to
listing_df
objects using the rlistings
R
package.
Specifically, the following topics will be covered:
To learn more about how listings are constructed using the
rlistings
package, see the Getting
Started vignette.
In many cases, listings have more rows or more columns than can fit on a single page. When this occurs, we may choose to use pagination to improve the readability of the listing and/or to fit in onto a standard-sized page for exporting or printing. When pagination is applied, all listing annotations (titles & footers) are printed on each of the returned pages. Note that currently only mono-spaced fonts are supported for pagination as characters are used to measure text width.
Vertical pagination occurs when a listing is especially long and has too many rows to fit on one page, while horizontal pagination is applied when a listing is especially wide and has too many columns to print on a single page. When horizontal pagination is applied to a listing, any key columns that have been specified for the listing will be repeated as the leftmost columns on each page. If a value from a key column, for example a subject ID, is present in rows that extend over several pages, that key column value will be printed at the top of each page.
The paginate_listing
function paginates a listing object
and returns a list of listing objects with each list element
corresponding to a separate page. This function should be used if you
want to paginate a listing to view within your R console or you would
like to process the list of paginated output further before
exporting.
In the R code below, we will give a basic example of how to create a
listing with rlistings
from a pre-processed data frame and
paginate the listing using paginate_listing
.
We first load in the rlistings
package.
For the purpose of this example we will use the dummy ADAE dataset
provided within the formatters
package as our data frame,
which consists of 48 columns of adverse event patient data, and one or
more rows per patient. For the purpose of this example, we will subset
the data and only use the first 100 records of the dataset.
Now we will create a basic listing.
lsting <- as_listing(
df = adae,
key_cols = c("USUBJID", "ARM"),
disp_cols = c("AETOXGR", "AEDECOD", "AESEV"),
main_title = "Title",
main_footer = "Footer"
)
head(lsting, 20)
#> Title
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-1-id-141 C: Combination 3 dcd B.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 5 dcd D.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-236 B: Placebo 5 dcd B.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-265 C: Combination 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-42 A: Drug X 2 dcd C.2.1.2.1 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 2 dcd C.2.1.2.1 MODERATE
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
In the listing output above, notice that there are two key columns that we expect to be repeated on each page after pagination.
Next, we see how the pagination works with the default settings via
the paginate_listing
function that is a wrapper of
paginate_to_mpfs()
that is the core pagination function and
lives in formatters
. Default pagination applies the
following settings, which are adjustable via the parameter specified in
parentheses:
"letter"
(page_type
) - other
options: "a4"
, "legal"
"Courier"
(font_family
) -
other options: "mono"
, "NimbusMon"
,
"Japan1"
, "Japan1HeiMin"
,
"Japan1GothicBBB"
, "Japan1Ryumin"
,
"Korea1"
, "Korea1deb"
, "CNS1"
,
"GB1"
8
(font_size
)1
(line_height
)FALSE
- portrait orientation
(landscape
)0.5
, 0.75
- inches for top/bottom
and left/right margins, respectively (margins
)These parameters, as well as some additional arguments not listed
here (see ?paginate_listing
for all options), can be set to
fine-tune your pagination output.
paginate_listing(lsting)
#> --- Page 1/4 ---
#> Title
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X 3
#> 3
#> 2
#> 2
#> AB12345-BRA-1-id-141 C: Combination 3
#> 1
#> 1
#> 2
#> 1
#> 5
#> AB12345-BRA-1-id-236 B: Placebo 5
#> 5
#> 5
#> AB12345-BRA-1-id-265 C: Combination 2
#> 3
#> 5
#> 4
#> AB12345-BRA-1-id-42 A: Drug X 2
#> 5
#> 2
#> 2
#> 1
#> 2
#> 5
#> 2
#> 4
#> 5
#> AB12345-BRA-1-id-65 B: Placebo 2
#> 1
#> 5
#> 4
#> AB12345-BRA-1-id-93 A: Drug X 3
#> 1
#> 1
#> 1
#> 4
#> 5
#> 5
#> 1
#> 1
#> AB12345-BRA-11-id-237 C: Combination 1
#> 4
#> 3
#> AB12345-BRA-11-id-321 C: Combination 1
#> 1
#> 2
#> 2
#> 1
#> 1
#> 1
#> 3
#> 5
#> AB12345-BRA-11-id-345 A: Drug X 3
#> 3
#> 1
#> 5
#> AB12345-BRA-11-id-397 A: Drug X 3
#> 3
#> 3
#> 5
#> 1
#> 5
#> AB12345-BRA-11-id-50 A: Drug X 3
#> 4
#> 2
#> AB12345-BRA-11-id-9 C: Combination 3
#> 1
#> 5
#> 5
#> 1
#> 2
#> 2
#> 3
#> AB12345-BRA-12-id-59 B: Placebo 5
#> 1
#> 3
#> 1
#> 3
#> 2
#> 3
#> 1
#> 4
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> --- Page 2/4 ---
#> Title
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-1-id-141 C: Combination dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd D.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-236 B: Placebo dcd B.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-265 C: Combination dcd C.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-42 A: Drug X dcd C.2.1.2.1 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd C.2.1.2.1 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd B.2.2.3.1 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> dcd A.1.1.1.2 MODERATE
#> dcd C.1.1.1.3 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-65 B: Placebo dcd C.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-93 A: Drug X dcd D.1.1.4.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd D.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd D.2.1.5.3 MILD
#> dcd B.2.2.3.1 MILD
#> AB12345-BRA-11-id-237 C: Combination dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-11-id-321 C: Combination dcd A.1.1.1.1 MILD
#> dcd A.1.1.1.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd B.2.1.2.1 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-345 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-397 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-50 A: Drug X dcd D.1.1.4.2 MODERATE
#> dcd C.1.1.1.3 SEVERE
#> dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-11-id-9 C: Combination dcd D.1.1.4.2 MODERATE
#> dcd B.2.2.3.1 MILD
#> dcd D.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd B.2.2.3.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-12-id-59 B: Placebo dcd D.1.1.1.1 SEVERE
#> dcd B.2.2.3.1 MILD
#> dcd D.1.1.4.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> --- Page 3/4 ---
#> Title
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-12-id-59 B: Placebo 3
#> AB12345-BRA-13-id-177 A: Drug X 3
#> 1
#> 5
#> 4
#> 3
#> 5
#> AB12345-BRA-14-id-120 C: Combination 2
#> 2
#> 2
#> 1
#> 2
#> 2
#> 1
#> 2
#> 2
#> 1
#> AB12345-BRA-14-id-23 A: Drug X 3
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> --- Page 4/4 ---
#> Title
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-12-id-59 B: Placebo dcd D.1.1.4.2 MODERATE
#> AB12345-BRA-13-id-177 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> dcd B.2.1.2.1 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-14-id-120 C: Combination dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.2.3.1 MILD
#> AB12345-BRA-14-id-23 A: Drug X dcd B.2.1.2.1 MODERATE
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
We can see from the above output that applying pagination separated our listing into 4 pages (list elements). Each page includes the two key columns as well as however many display columns fit horizontally on the page. Pages 1 and 3 contain only the key columns and the “Analysis Toxicity Grade” column, while the overflowing columns from these pages are present on pages 2 and 4, respectively. Additionally, vertical pagination is applied for this listing, with 20 rows that do not fit vertically on pages 1 and 2 overflowing onto pages 3 and 4, respectively. We can also see that the last subject included on pages 1 and 2, with subject ID “AB12345-BRA-12-id-59”, has additional rows that overflow onto pages 3 and 4, and the key column values for this subject are repeated in the first line of these two pages.
In addition to specifying page_type
, there are three
alternative methods that can be used to specify page size when
paginating a listing:
pg_width
and pg_height
lpp
and cpp
colwidths
If method 1 or 2 is implemented, the page_type
argument
will be ignored.
pg_width
and pg_height
As an alternative to specifying page type, the user can instead
supply page width (pg_width
) and
page height (pg_height
) values in inches to define the page
size.
lpp
and cpp
For more control users can instead set the lpp
(lines
per page) and cpp
(characters per page) parameters to set
an exact number of rows in the vertical dimension that should be
included per page, and characters per line that should be included per
page in the horizontal dimension, respectively. If NULL
is
supplied to either of these parameters, pagination in the associated
dimension will not be applied.
Considerations when using lpp
and cpp
:
lpp
value must include lines for titles and
footers, which are included on every page.lpp
as 5.See the following example which uses lpp
and
cpp
instead of page_type
to specify page
size:
paginate_listing(lsting, lpp = 50, cpp = NULL)
#> --- Page 1/3 ---
#> Title
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-1-id-141 C: Combination 3 dcd B.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 5 dcd D.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-236 B: Placebo 5 dcd B.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-265 C: Combination 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-42 A: Drug X 2 dcd C.2.1.2.1 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd B.2.2.3.1 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 5 dcd B.1.1.1.1 SEVERE
#> 2 dcd A.1.1.1.2 MODERATE
#> 4 dcd C.1.1.1.3 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-65 B: Placebo 2 dcd C.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-93 A: Drug X 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 1 dcd D.2.1.5.3 MILD
#> 4 dcd C.1.1.1.3 SEVERE
#> 5 dcd D.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd B.2.2.3.1 MILD
#> AB12345-BRA-11-id-237 C: Combination 1 dcd D.2.1.5.3 MILD
#> 4 dcd C.1.1.1.3 SEVERE
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> --- Page 2/3 ---
#> Title
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-11-id-237 C: Combination 3 dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-11-id-321 C: Combination 1 dcd A.1.1.1.1 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 3 dcd B.2.1.2.1 MODERATE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-345 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-397 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 1 dcd D.2.1.5.3 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-50 A: Drug X 3 dcd D.1.1.4.2 MODERATE
#> 4 dcd C.1.1.1.3 SEVERE
#> 2 dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-11-id-9 C: Combination 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd B.2.2.3.1 MILD
#> 5 dcd D.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 1 dcd B.2.2.3.1 MILD
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-12-id-59 B: Placebo 5 dcd D.1.1.1.1 SEVERE
#> 1 dcd B.2.2.3.1 MILD
#> 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 3 dcd B.2.1.2.1 MODERATE
#> 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd B.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 4 dcd C.1.1.1.3 SEVERE
#> 3 dcd D.1.1.4.2 MODERATE
#> AB12345-BRA-13-id-177 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> --- Page 3/3 ---
#> Title
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-13-id-177 A: Drug X 1 dcd D.2.1.5.3 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> 3 dcd B.2.1.2.1 MODERATE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-14-id-120 C: Combination 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd C.2.1.2.1 MODERATE
#> 1 dcd B.2.2.3.1 MILD
#> AB12345-BRA-14-id-23 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
Here we set lpp
to 50 which shortens the vertical length
of each page to a maximum of 50 lines (8 rows of header/footer
information + 42 rows of data). By setting cpp
to
NULL
we disable pagination in the horizontal direction so
that all columns fit horizontally across each page.
colwidths
When applying horizontal pagination, the colwidths
parameter can be set via a numeric vector with widths to use for each
column. The length of this vector must be equal to the number of columns
in the listing, with each element corresponding to the column of the
listing at the same index.
Considerations when using colwidths
:
export_as_txt
As with paginate_listing
, export_as_txt
can
also be used to paginate listing objects. Instead of returning a list of
listings by page, the export_as_txt
function will, if no
file is specified, return a concatenated string value of all of the page
content resulting after pagination. If the file
parameter
is specified, the export_as_txt
function will instead write
the result to the supplied .txt
file.
The export_as_txt
function contains all of the arguments
available in paginate_listing
, which work the same way,
plus some additional arguments that are useful for listing
pagination:
file
: The path to write a text file to, with the
paginated listing rendered as ASCII text.hsep
: Character to repeat to create separator line
between header/footer and body.page_break
: Page break symbol. Defaults to
"\\s\\n"
.Note that if the paginate
argument is set to
FALSE
, no pagination will occur.
See an example using export_as_txt
below. We use the
cat
function to make the output more easily readable in the
console:
cat(export_as_txt(lsting))
#> Title
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X 3
#> 3
#> 2
#> 2
#> AB12345-BRA-1-id-141 C: Combination 3
#> 1
#> 1
#> 2
#> 1
#> 5
#> AB12345-BRA-1-id-236 B: Placebo 5
#> 5
#> 5
#> AB12345-BRA-1-id-265 C: Combination 2
#> 3
#> 5
#> 4
#> AB12345-BRA-1-id-42 A: Drug X 2
#> 5
#> 2
#> 2
#> 1
#> 2
#> 5
#> 2
#> 4
#> 5
#> AB12345-BRA-1-id-65 B: Placebo 2
#> 1
#> 5
#> 4
#> AB12345-BRA-1-id-93 A: Drug X 3
#> 1
#> 1
#> 1
#> 4
#> 5
#> 5
#> 1
#> 1
#> AB12345-BRA-11-id-237 C: Combination 1
#> 4
#> 3
#> AB12345-BRA-11-id-321 C: Combination 1
#> 1
#> 2
#> 2
#> 1
#> 1
#> 1
#> 3
#> 5
#> AB12345-BRA-11-id-345 A: Drug X 3
#> 3
#> 1
#> 5
#> AB12345-BRA-11-id-397 A: Drug X 3
#> 3
#> 3
#> 5
#> 1
#> 5
#> AB12345-BRA-11-id-50 A: Drug X 3
#> 4
#> 2
#> AB12345-BRA-11-id-9 C: Combination 3
#> 1
#> 5
#> 5
#> 1
#> 2
#> 2
#> 3
#> AB12345-BRA-12-id-59 B: Placebo 5
#> 1
#> 3
#> 1
#> 3
#> 2
#> 3
#> 1
#> 4
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-1-id-141 C: Combination dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd D.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-236 B: Placebo dcd B.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-265 C: Combination dcd C.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-42 A: Drug X dcd C.2.1.2.1 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd C.2.1.2.1 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd B.2.2.3.1 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> dcd A.1.1.1.2 MODERATE
#> dcd C.1.1.1.3 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-65 B: Placebo dcd C.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-1-id-93 A: Drug X dcd D.1.1.4.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd D.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd D.2.1.5.3 MILD
#> dcd B.2.2.3.1 MILD
#> AB12345-BRA-11-id-237 C: Combination dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-11-id-321 C: Combination dcd A.1.1.1.1 MILD
#> dcd A.1.1.1.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd B.2.1.2.1 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-345 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-397 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-50 A: Drug X dcd D.1.1.4.2 MODERATE
#> dcd C.1.1.1.3 SEVERE
#> dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-11-id-9 C: Combination dcd D.1.1.4.2 MODERATE
#> dcd B.2.2.3.1 MILD
#> dcd D.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd B.2.2.3.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-12-id-59 B: Placebo dcd D.1.1.1.1 SEVERE
#> dcd B.2.2.3.1 MILD
#> dcd D.1.1.4.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-12-id-59 B: Placebo 3
#> AB12345-BRA-13-id-177 A: Drug X 3
#> 1
#> 5
#> 4
#> 3
#> 5
#> AB12345-BRA-14-id-120 C: Combination 2
#> 2
#> 2
#> 1
#> 2
#> 2
#> 1
#> 2
#> 2
#> 1
#> AB12345-BRA-14-id-23 A: Drug X 3
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-12-id-59 B: Placebo dcd D.1.1.4.2 MODERATE
#> AB12345-BRA-13-id-177 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> dcd B.2.1.2.1 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-14-id-120 C: Combination dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.2.3.1 MILD
#> AB12345-BRA-14-id-23 A: Drug X dcd B.2.1.2.1 MODERATE
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
Notice the page break symbol (\s\n
) is repeated where
page breaks occur (i.e. prior to the title on each new page).
export_as_rtf
The export_as_rtf
function can be used similarly to
export_as_txt
to paginate and export listings except this
function will write output to a supplied .rtf
file
containing the listing output. If no file is supplied, the
RTF
formatted output will be printed to the console. See
?export_as_rtf
for more details on this function.
In addition to paginating by page size as described in the previous
sections of this vignette, a user may also want to paginate their
listing such that each page corresponds to a different value of a given
parameter. For example, you may require that each treatment arm is
printed on a separate page. This can currently be done with
rlistings
using the split_listing_by_var
function, which can be applied to your pre-existing listing as
follows:
lsting_by_arm <- lsting %>%
split_into_pages_by_var("ARM", page_prefix = "Treatment Arm")
lsting_by_arm
#> $`A: Drug X`
#> Title
#> Treatment Arm: A: Drug X
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-1-id-42 A: Drug X 2 dcd C.2.1.2.1 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd B.2.2.3.1 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 5 dcd B.1.1.1.1 SEVERE
#> 2 dcd A.1.1.1.2 MODERATE
#> 4 dcd C.1.1.1.3 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-93 A: Drug X 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 1 dcd D.2.1.5.3 MILD
#> 4 dcd C.1.1.1.3 SEVERE
#> 5 dcd D.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd B.2.2.3.1 MILD
#> AB12345-BRA-11-id-345 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-397 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 1 dcd D.2.1.5.3 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-50 A: Drug X 3 dcd D.1.1.4.2 MODERATE
#> 4 dcd C.1.1.1.3 SEVERE
#> 2 dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-13-id-177 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> 3 dcd B.2.1.2.1 MODERATE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-14-id-23 A: Drug X 3 dcd B.2.1.2.1 MODERATE
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> $`C: Combination`
#> Title
#> Treatment Arm: C: Combination
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-141 C: Combination 3 dcd B.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 5 dcd D.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-265 C: Combination 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd D.1.1.4.2 MODERATE
#> 5 dcd D.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-11-id-237 C: Combination 1 dcd D.2.1.5.3 MILD
#> 4 dcd C.1.1.1.3 SEVERE
#> 3 dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-11-id-321 C: Combination 1 dcd A.1.1.1.1 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd D.2.1.5.3 MILD
#> 1 dcd A.1.1.1.1 MILD
#> 3 dcd B.2.1.2.1 MODERATE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-9 C: Combination 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd B.2.2.3.1 MILD
#> 5 dcd D.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 1 dcd B.2.2.3.1 MILD
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-14-id-120 C: Combination 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 2 dcd A.1.1.1.2 MODERATE
#> 2 dcd A.1.1.1.2 MODERATE
#> 1 dcd A.1.1.1.1 MILD
#> 2 dcd C.2.1.2.1 MODERATE
#> 2 dcd C.2.1.2.1 MODERATE
#> 1 dcd B.2.2.3.1 MILD
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#>
#> $`B: Placebo`
#> Title
#> Treatment Arm: B: Placebo
#>
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade Dictionary-Derived Term Severity/Intensity
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-236 B: Placebo 5 dcd B.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> 5 dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-65 B: Placebo 2 dcd C.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 5 dcd B.1.1.1.1 SEVERE
#> 4 dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-12-id-59 B: Placebo 5 dcd D.1.1.1.1 SEVERE
#> 1 dcd B.2.2.3.1 MILD
#> 3 dcd D.1.1.4.2 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 3 dcd B.2.1.2.1 MODERATE
#> 2 dcd C.2.1.2.1 MODERATE
#> 3 dcd B.2.1.2.1 MODERATE
#> 1 dcd D.2.1.5.3 MILD
#> 4 dcd C.1.1.1.3 SEVERE
#> 3 dcd D.1.1.4.2 MODERATE
#> ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
As with paginate_listing
, this creates a list of
listings where each list element corresponds to a new page, but with
each page corresponding to only one value of the given parameter. Note
that the page_prefix
argument can be specified to modify
the text printed on each page to describe the current parameter
value.
To then apply regular pagination to the listing, you can apply
paginate_listing
to your list of listings by parameter. Any
arguments supplied to this function will be applied to each list
element.
export_as_txt
Similarly, for pagination via export_as_txt
after
paginating by parameter, you can apply export_as_txt
to
your list of listings by parameter. Any arguments supplied to
export_as_txt
will be applied to each list element and the
list will then be concatenated into the correct text format.
For example:
cat(export_as_txt(lsting_by_arm))
#> Title
#> Treatment Arm: A: Drug X
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X 3
#> 3
#> 2
#> 2
#> AB12345-BRA-1-id-42 A: Drug X 2
#> 5
#> 2
#> 2
#> 1
#> 2
#> 5
#> 2
#> 4
#> 5
#> AB12345-BRA-1-id-93 A: Drug X 3
#> 1
#> 1
#> 1
#> 4
#> 5
#> 5
#> 1
#> 1
#> AB12345-BRA-11-id-345 A: Drug X 3
#> 3
#> 1
#> 5
#> AB12345-BRA-11-id-397 A: Drug X 3
#> 3
#> 3
#> 5
#> 1
#> 5
#> AB12345-BRA-11-id-50 A: Drug X 3
#> 4
#> 2
#> AB12345-BRA-13-id-177 A: Drug X 3
#> 1
#> 5
#> 4
#> 3
#> 5
#> AB12345-BRA-14-id-23 A: Drug X 3
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#> Treatment Arm: A: Drug X
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-134 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-1-id-42 A: Drug X dcd C.2.1.2.1 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd C.2.1.2.1 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd B.2.2.3.1 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> dcd A.1.1.1.2 MODERATE
#> dcd C.1.1.1.3 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-93 A: Drug X dcd D.1.1.4.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd D.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd D.2.1.5.3 MILD
#> dcd B.2.2.3.1 MILD
#> AB12345-BRA-11-id-345 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-397 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-50 A: Drug X dcd D.1.1.4.2 MODERATE
#> dcd C.1.1.1.3 SEVERE
#> dcd A.1.1.1.2 MODERATE
#> AB12345-BRA-13-id-177 A: Drug X dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> dcd B.2.1.2.1 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-14-id-23 A: Drug X dcd B.2.1.2.1 MODERATE
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#> Treatment Arm: C: Combination
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-141 C: Combination 3
#> 1
#> 1
#> 2
#> 1
#> 5
#> AB12345-BRA-1-id-265 C: Combination 2
#> 3
#> 5
#> 4
#> AB12345-BRA-11-id-237 C: Combination 1
#> 4
#> 3
#> AB12345-BRA-11-id-321 C: Combination 1
#> 1
#> 2
#> 2
#> 1
#> 1
#> 1
#> 3
#> 5
#> AB12345-BRA-11-id-9 C: Combination 3
#> 1
#> 5
#> 5
#> 1
#> 2
#> 2
#> 3
#> AB12345-BRA-14-id-120 C: Combination 2
#> 2
#> 2
#> 1
#> 2
#> 2
#> 1
#> 2
#> 2
#> 1
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#> Treatment Arm: C: Combination
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-141 C: Combination dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd D.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-265 C: Combination dcd C.2.1.2.1 MODERATE
#> dcd D.1.1.4.2 MODERATE
#> dcd D.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-11-id-237 C: Combination dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-11-id-321 C: Combination dcd A.1.1.1.1 MILD
#> dcd A.1.1.1.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.1 MILD
#> dcd B.2.1.2.1 MODERATE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-11-id-9 C: Combination dcd D.1.1.4.2 MODERATE
#> dcd B.2.2.3.1 MILD
#> dcd D.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd B.2.2.3.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.1.2.1 MODERATE
#> AB12345-BRA-14-id-120 C: Combination dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.2 MODERATE
#> dcd A.1.1.1.1 MILD
#> dcd C.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.2.3.1 MILD
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#> Treatment Arm: B: Placebo
#>
#> ————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Analysis Toxicity Grade
#> ————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-236 B: Placebo 5
#> 5
#> 5
#> AB12345-BRA-1-id-65 B: Placebo 2
#> 1
#> 5
#> 4
#> AB12345-BRA-12-id-59 B: Placebo 5
#> 1
#> 3
#> 1
#> 3
#> 2
#> 3
#> 1
#> 4
#> 3
#> ————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
#> \s\nTitle
#> Treatment Arm: B: Placebo
#>
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> Unique Subject Identifier Description of Planned Arm Dictionary-Derived Term Severity/Intensity
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#> AB12345-BRA-1-id-236 B: Placebo dcd B.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> dcd B.1.1.1.1 SEVERE
#> AB12345-BRA-1-id-65 B: Placebo dcd C.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.1.1.1.1 SEVERE
#> dcd C.1.1.1.3 SEVERE
#> AB12345-BRA-12-id-59 B: Placebo dcd D.1.1.1.1 SEVERE
#> dcd B.2.2.3.1 MILD
#> dcd D.1.1.4.2 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd B.2.1.2.1 MODERATE
#> dcd C.2.1.2.1 MODERATE
#> dcd B.2.1.2.1 MODERATE
#> dcd D.2.1.5.3 MILD
#> dcd C.1.1.1.3 SEVERE
#> dcd D.1.1.4.2 MODERATE
#> —————————————————————————————————————————————————————————————————————————————————————————————————————
#>
#> Footer
Again, we use the cat
function to make the text output
more easily readable in the console.
In this vignette, you have learned how to use the
rlistings
package to paginate listings. You have seen
examples demonstrating how custom pagination can be configured, as well
as examples of pagination applied using exporter functions. You have
also seen learned how pagination can be applied with pages separated by
value of a given parameter.
For more information on listings pagination please see
?paginate_listing
.