new_tibble {tibble} | R Documentation |
Creates a subclass of a tibble. This function is mostly useful for package authors that implement subclasses of a tibble, like sf or tibbletime.
new_tibble(x, ..., nrow = NULL, subclass = NULL)
x |
A tibble-like object |
... |
Passed on to |
nrow |
The number of rows, guessed from the data by default |
subclass |
Subclasses to assign to the new object, default: none |
x
must be a named (or empty) list, but the names are not currently
checked for correctness.
The ...
argument allows adding more attributes to the subclass.
The row.names
attribute will be computed from the nrow
argument,
overriding any existing attribute of this name in x
or in the ...
arguments.
If nrow
is NULL
, the number of rows will be guessed from the data.
The new_tibble()
constructor makes sure that the row.names
attribute
is consistent with the data before returning.
The class
attribute of the returned object always consists of
c("tbl_df", "tbl", "data.frame")
. If the subclass
argument is set,
it will be prepended to that list of classes.
new_tibble(list(a = 1:3, b = 4:6)) # One particular situation where the nrow argument is essential: new_tibble(list(), nrow = 150, subclass = "my_tibble") # It's safest to always pass it along: new_tibble(list(a = 1:3, b = 4:6), nrow = 3) ## Not run: # All columns must be the same length: new_tibble(list(a = 1:3, b = 4.6)) # The length must be consistent with the nrow argument if available: new_tibble(list(a = 1:3, b = 4:6), nrow = 2) ## End(Not run)