Learning Objectives: After this chapter you will be able to:
Create a list that holds elements of different types.
Name list elements with names().
Access elements with [[, [, and $.
Explain why [[ returns the element while [ returns a list.
Convert a vector or matrix into a list with as.list().
Convert a list back into a vector with unlist().
12.1 Introduction
Lists are very useful as they are heterogeneous: they can contain different data types. Vectors and matrices are homogeneous: they can contain only one type of data. A matrix is a rectangular arrangement of values of one type, with rows and columns. If you include different data types in a vector or matrix, R coerces them to the same type. With lists, it is different. In this chapter, we will learn more about lists.
12.2 Creating Lists
To create a list, we use the list() function. Let us create a simple list to demonstrate how it can contain different data types.
In the output, all the elements of the list retain their data types. Let us learn how to access the elements of the list.
12.3 Access List Elements
You can access the elements of a list using the following operators:
[[
[
$
Let us try them one by one.
# using [[l[[1]]
[1] 1 2 3 4 5 6 7 8 9 10
# using [l[1]
[[1]]
[1] 1 2 3 4 5 6 7 8 9 10
[[ extracts the element itself (which may be a vector, matrix, data frame, or nested list), while [ returns a new list containing the selected element(s). We can use the $ operator only when we have named elements in the list. Let us add names to the elements using the names() function.
# named elementsnames(l) <-c('vect1', 'vect2', 'vect3', 'mat')l
Knowledge Check:Why use a list at all?vect1 <- 1:10, vect2 <- c('Jack', 'John', 'Jill'), and vect3 <- c(TRUE, FALSE). Why not just c(vect1, vect2, vect3)?
Click to reveal answer
Answer: That would coerce everything to character, because character is the most flexible type. A list keeps each element’s own type.
Explanation:c(vect1, vect2, vect3) gives you c("1", "2", ..., "10", "Jack", ...). Vectors and matrices are homogeneous, so mixing types destroys information. list(vect1, vect2, vect3) stores the three vectors side by side with their types intact.
Knowledge Check:[[ versus [ Given l <- list(1:10, c('Jack', 'John')), what is the difference between l[[1]] and l[1]?
Click to reveal answer
Answer:l[[1]] is the vector 1:10 itself. l[1] is a list containing one element, which is that same vector.
Explanation:[[ extracts the element, so you get the object and can operate on it directly. [ builds a new list holding the selection, which is what you want when you want to delete or keep several elements. Square brackets are for selecting; double square brackets are for extracting.
Knowledge Check:$ needs names Why does l$vect1 fail before you run names(l) <- c('vect1', 'vect2', 'vect3', 'mat')?
Click to reveal answer
Answer: The elements have no names, so there is nothing for $ to match.
Explanation:$ looks up elements by name, not by position. Until the list has names, use l[[1]] or l[1]. Once named, l$vect1 and l[['vect1']] both return the vector.
Knowledge Check:Coercing to a list How do you turn the vector vect1 <- 1:10 into a list, one element per value?
Click to reveal answer
Answer:as.list(vect1), which gives a list of ten single numbers.
Explanation:as.list() splits the vector into its individual elements. The same call works on a matrix, in which case every value of the matrix becomes its own element (nine elements for a 3 x 3 matrix, taken column by column). The reverse direction is unlist().
Knowledge Check:Flattening a list What does unlist(l, use.names = FALSE) do differently from unlist(l)?
Click to reveal answer
Answer: It returns the same values but without the names.
Explanation:unlist() concatenates every element into one vector and keeps the names it finds, so you get a named vector. Setting use.names = FALSE drops the names, which is usually what you want for further calculation.
Key points
A list can hold elements of different types without coercing them to one type.
Use [[ to extract an element and [ to keep a selection as a list.
Name list elements to access them with $.
Use as.list() to create a list and unlist() to flatten one into a vector.