[R] unlist

Rozložení seznamu (list)

Popis

Funkce unlist zjednoduší strukturu seznamu x do vektoru, který obsahuje všechny atomické komponenty původně obsažené v x.

Použití

Argumenty

Podrobnosti

Funkce unlist je generická: lze vytvářet metody pro manipulaci se specifickými třídami objektů, viz InternalMethods. Např. funkce relist s metodou unlist pro objekty třídy relistable.

V případě, že recursive = FALSE, funkce nerozkládá vnořené seznamy nižších úrovní a zpracuje pouze nejvyšší úroveň seznamu.

Faktory jsou zpracovány speciálním způsobem. Pokud jsou všechny prvky x faktory (příp. seřazené faktory), je výsledkem faktor s úrovněmi danými sjednocením množin faktorových úrovní původních prvků v takovém pořadí, v jakém se vyskytují v původních množinách faktorových úrovní původních prvků (což znamená, že pokud mají všechny původní prvky stejnou množinu faktorovýh úrovní, je tato množina současně výslednou množinou úrovní faktorů).

x může být atomický vektor, ovšem v takovém případě funkce unlist neprovádí nic kromě odstranění názvů.

V základním nastavení se funkce unlist pokouší zachovat informaci o názvech v x. Pokud use.names = FALSE, jsou odstraněny veškeré informace o názvech.

Poku je to možné, jsou všechny prvky budoucího vektoru převedeny na stejný datový typ, což často vede k tomu, že rozklad seznamu končí textovým vektorem. Podle možností jsou totiž vektory změněny na nejnižší nutný typ pro zachování obsahu v hierarchii NULL < raw < logical < integer < double < complex < character < list < expression. Párové seznamy jsou zpracovávány jako seznamy.

Seznam je (generický) vektor a zjednodušený vektor může být stále seznamem (a může být dokonce po průchodu funkcí nezměněn). Nevektorové komponenty seznamu (například prvky jazyka jako jsou názvy, vzorce a volání) nejsou změněny a tedy seznam, který obsahuje jeden nebo více takových komponent, zůstane seznamem. (Efektem rozkladu seznamu lm prokladu je vytvoření seznamu obsahujcího jednotlivá rezidua modelu jako prvky.) Povšimněte si, že unlist(x) v případě nevektorového x vrací nezměněné x namísto chybové hlášky.

Hodnota

NULL nebo výraz nebo vektor příslušného typu pro zachování komponent seznamu.

Datový typ je určen podle nejvyššího z typů jednotlivých komponent v hierarchii NULL < raw < logical < integer < double < complex < character < list < expression při změně párových seznamů na seznamy.

Reference

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.

Viz také

c, as.list, relist.

Příklady

unlist(options())
unlist(options(), use.names = FALSE)

l.ex <- list(a = list(1:5, LETTERS[1:5]), b = "Z", c = NA)
unlist(l.ex, recursive = FALSE)
unlist(l.ex, recursive = TRUE)

l1 <- list(a = "a", b = 2, c = pi+2i)
unlist(l1) # textovy vektor
l2 <- list(a = "a", b = as.name("b"), c = pi+2i)
unlist(l2) # zustava seznamem

ll <- list(as.name("sinc"), quote( a + b ), 1:10, letters, expression(1+x))
utils::str(ll)
for(x in ll)
stopifnot(identical(x, unlist(x)))

Komentáře: