utils (version 3.3)

head: Return the First or Last Part of an Object

Description

Returns the first or last parts of a vector, matrix, table, data frame or function. Since head() and tail() are generic functions, they may also have been extended to other classes.

Usage

head(x, ...)
## S3 method for class 'default':
head(x, n = 6L, \dots)
## S3 method for class 'data.frame':
head(x, n = 6L, \dots)
## S3 method for class 'matrix':
head(x, n = 6L, \dots)
## S3 method for class 'ftable':
head(x, n = 6L, \dots)
## S3 method for class 'table':
head(x, n = 6L, \dots)
## S3 method for class 'function':
head(x, n = 6L, \dots)
tail(x, ...)
## S3 method for class 'default':
tail(x, n = 6L, \dots)
## S3 method for class 'data.frame':
tail(x, n = 6L, \dots)
## S3 method for class 'matrix':
tail(x, n = 6L, addrownums = TRUE, \dots)
## S3 method for class 'ftable':
tail(x, n = 6L, addrownums = FALSE, \dots)
## S3 method for class 'table':
tail(x, n = 6L, addrownums = TRUE, \dots)
## S3 method for class 'function':
tail(x, n = 6L, \dots)

Arguments

x

an object

n

a single integer. If positive, size for the resulting object: number of elements for a vector (including lists), rows for a matrix or data frame or lines for a function. If negative, all but the n last/first number of elements of x.

addrownums

if there are no row names, create them from the row numbers.

...

arguments to be passed to or from other methods.

Value

• An object (usually) like x but generally smaller. For ftable objects x, a transformed format(x).

Details

For matrices, 2-dim tables and data frames, head() (tail()) returns the first (last) n rows when n > 0 or all but the last (first) n rows when n < 0. head.matrix() and tail.matrix() are exported. For functions, the lines of the deparsed function are returned as character strings.

If a matrix has no row names, then tail() will add row names of the form "[n,]" to the result, so that it looks similar to the last lines of x when printed. Setting addrownums = FALSE suppresses this behaviour.

Examples

head(letters)
head(letters, n = -6L)

head(freeny.x, n = 10L)
head(freeny.y)

tail(letters)
tail(letters, n = -6L)

tail(freeny.x)
tail(freeny.y)

tail(library)

head(stats::ftable(Titanic))

Run the code above in your browser using DataCamp Workspace