listar: Incorporar objetos a una lista

In academia-i/ai.elementalr.es: Funciones Elementales Para Manipular Datos, De Academia I (En Español)

Description

Agregar objetos a una lista de forma rápida controlando la posición y qué pasa con el objeto en el entorno global (GlobalEnv).

Usage

listar(lista, obj, pos = 0, rm = T)

Arguments

lista	Una lista. Si la lista no existe en el entorno global (GlobalEnv), la función creará una y le asignará el obejto.
obj	Objeto de cualquier tipo. Es necesario que exista previamente en el entorno global (GlobalEnv).
pos	Un número. Puede asumir dos valores: 0: la fila se añade al final la lista (por defecto); 1: la fila se añade al principio de la lista;
rm	Valor lógico. Si es TRUE (predeterminado), el objeto será eliminado del entorno global (GlobalEnvir) después de ser agregado a la lista. Si es FALSE, el objeto será añadido a la lista sin ser eliminado del entorno global.

Details

Si obj no existe antes de aplicar la función, arrojará error. Debe existir antes en el entorno global.

Si listar() se usa dentro de una función personalizada, debe definirse rm = FALSE. De lo contrario, arrojará error.

Si listar() se usa múltiples veces en un pipe de magrittr (el %>%), sólo añadirá el último objeto de la secuencia.

Value

Una lista con el obj incorporado en la posición indicada con el argumento pos.

Examples

# Creamos primero una lista a la después se le agregarán elementos.

mis_cosas <- list(
   libros = c("El péndulo de Foucault", "Germinal", "Artificios", "Angela's Ashes"),
   vinilos = c("Abbey Road", "Kind of blue", "Nevermind",
    "Bigger, better, faster, more", "Parte de la religión")
  )

 # Creamos después elementos para agregar a la lista

computadoras <- c("Notebook", "Workstation", "Raspberry Pi")

# Agregando el objeto al final de la lista y conservándolo en el entorno global:
  mis_cosas <- listar(mis_cosas, computadoras, pos = 0, rm = FALSE)

# Agregando el objeto al primer lugar de la lista y eliminándolo del entorno global:
  mis_cosas <- listar(mis_cosas, computadoras, pos = 1, rm = TRUE)

academia-i/ai.elementalr.es documentation built on Dec. 18, 2021, 10:21 p.m.