Списки с классом

S3 — самая старая и наиболее используемая система объектов в R. Объект S3 — это обычный список с атрибутом class, меткой, которая указывает, что это за тип объекта. class(x) <- "dog" задаёт метку:

rex <- list(name = "Rex", age = 3)
class(rex) <- "dog"
print(class(rex))
cat(rex$name, "is", rex$age)

Вывод:

[1] "dog"
Rex is 3

structure() создает значение и задает его атрибуты одним вызовом — это обычный способ создания объекта S3. Поля считываются с помощью $, как и в любом списке:

rex <- structure(list(name = "Rex", age = 3), class = "dog")
print(class(rex))
print(is.list(rex))
print(rex$age)

Вывод:

[1] "dog"
[1] TRUE
[1] 3

Класс — это лишь метка: R не проверяет, какие поля есть у объекта, поэтому любой список можно назвать dog. unclass() удаляет метку и возвращает обычный список:

p <- structure(list(x = 1, y = 2), class = "point")
print(unclass(p))

Вывод:

$x
[1] 1

$y
[1] 2

Объекты S3 — это значения. Функция, изменяющая объект, изменяет его собственную копию, поэтому возвращает новую версию, а вызывающий код присваивает её. Исходный объект остаётся прежним:

birthday <- function(d) {
  d$age <- d$age + 1
  d
}
rex <- structure(list(name = "Rex", age = 3), class = "dog")
older <- birthday(rex)
cat(rex$age, older$age)

Вывод:

3 4