print.data.table {data.table} | R Documentation

## data.table Printing Options

### Description

`print.data.table` extends the functionalities of `print.data.frame`.

Key enhancements include automatic output compression of many observations and concise column-wise `class` summary.

### Usage

      ## S3 method for class 'data.table'
    print(x,
        topn=getOption("datatable.print.topn"),          # default: 5
        nrows=getOption("datatable.print.nrows"),        # default: 100
        class=getOption("datatable.print.class"),  # default: FALSE
        row.names=getOption("datatable.print.rownames"), # default: TRUE
        quote=FALSE,...)

### Arguments

`x` | A `data.table`.
`topn` | The number of rows to be printed from the beginning and end of tables with more than `nrows` rows.
`nrows` | The number of rows which will be printed before truncation is enforced.
`class` | If `TRUE`, the resulting output will include above each column its storage class (or a self-evident abbreviation thereof).
`row.names` | If `TRUE`, row indices will be printed alongside `x`.
`quote` | If `TRUE`, all output will appear in quotes, as in `print.default`.
`...` | Other arguments ultimately passed to `format`.

### Details

By default, with an eye to the typically large number of observations in a codedata.table, only the beginning and end of the object are displayed (specifically, `head(x, topn)` and `tail(x, topn)` are displayed unless `nrow(x) < nrows`, in which case all rows will print).

### See Also

`print.default`

### Examples

      #output compression
      DT <- data.table(a = 1:1000)
      print(DT, nrows = 100, topn = 4)

      #`quote` can be used to identify whitespace
      DT <- data.table(blanks = c(" 12", " 34"),
                       noblanks = c("12", "34"))
      print(DT, quote = TRUE)

      #`class` provides handy column type summaries at a glance
      DT <- data.table(a = vector("integer", 3),
                       b = vector("complex", 3),
                       c = as.IDate(paste0("2016-02-0", 1:3)))
      print(DT, class = TRUE)

      #`row.names` can be eliminated to save space
      DT <- data.table(a = 1:3)
      print(DT, row.names = FALSE)

[Package data.table version 1.10.4-1 Index]