R: Printing tibbles

formatting {tibble} | R Documentation

## Printing tibbles

### Description

One of the main features of the `tbl_df` class is the printing:

- Tibbles only print as many rows and columns as fit on one screen, supplemented by a summary of the remaining rows and columns.

- Tibble reveals the type of each column, which keeps the user informed about whether a variable is, e.g., `<chr>` or `<fct>` (character versus factor). See `vignette("types")` for an overview of common type abbreviations.

Printing can be tweaked for a one-off call by calling `print()` explicitly and setting arguments like `n` and `width`. More persistent control is available by setting the options described in pillar::pillar_options. See also `vignette("digits")` for a comparison to base options, and `vignette("numbers")` that showcases `num()` and `char()` for creating columns with custom formatting options.

As of tibble 3.1.0, printing is handled entirely by the pillar package. If you implement a package that extends tibble, the printed output can be customized in various ways. See `vignette("extending", package = "pillar")` for details, and pillar::pillar_options for options that control the display in the console.

### Usage

    ## S3 method for class 'tbl_df'
    print(
      x,
      width = NULL,
      ...,
      n = NULL,
      max_extra_cols = NULL,
      max_footer_lines = NULL
    )

    ## S3 method for class 'tbl_df'
    format(
      x,
      width = NULL,
      ...,
      n = NULL,
      max_extra_cols = NULL,
      max_footer_lines = NULL
    )

### Arguments

`x` | Object to format or print.
`width` | Width of text output to generate. This defaults to `NULL`, which means use the `width` option.
`...` | Passed on to `tbl_format_setup()`.
`n` | Number of rows to show. If `NULL`, the default, will print all rows if less than the `print_max` option. Otherwise, will print as many rows as specified by the `print_min` option.
`max_extra_cols` | Number of extra columns to print abbreviated information for, if the width is too small for the entire tibble. If `NULL`, the `max_extra_cols` option is used. The previously defined `n_extra` argument is soft-deprecated.
`max_footer_lines` | Maximum number of footer lines. If `NULL`, the `max_footer_lines` option is used.

### Examples

    print(as_tibble(mtcars))
    print(as_tibble(mtcars), n = 1)
    print(as_tibble(mtcars), n = 3)

    print(as_tibble(trees), n = 100)

    print(mtcars, width = 10)

    mtcars2 <- as_tibble(cbind(mtcars, mtcars), .name_repair = "unique")
    print(mtcars2, n = 25, max_extra_cols = 3)

    print(nycflights13::flights, max_footer_lines = 1)
    print(nycflights13::flights, width = Inf)

[Package tibble version 3.1.6 Index]