blockr.core (version 0.1.1)

rand_names: Random IDs

Description

Randomly generated unique IDs are used throughout the package, created by rand_names(). If random strings are required that may not clash with a set of existing values, this can be guaranteed by passing them as old_names. A blockr_option() rand_id can be set to swap out the function responsible for ID generation.

Usage

rand_names(
  old_names = character(0L),
  n = 1L,
  max_tries = 100L,
  id_fun = blockr_option("rand_id", NULL)
)
adjective_animal(n)
sample_letters(n)
resolve_ctor(ctor, ctor_pkg = NULL)
forward_ctor(x)
is_blockr_ctor(x)
ctor_name(x)
ctor_pkg(x)
ctor_fun(x)
to_sentence_case(x, replace = character(), with = character())
id_to_sentence_case(x)

Value

A character vector of length n where each entry contains length

characters (all among chars and start/end with prefix/suffix), is guaranteed to be unique and not present among values passed as old_names.

Arguments

old_names

Disallowed IDs

n

Number of IDs to generate

max_tries

Max number of attempts to create IDs that do not intersect with old_names

id_fun

A function with a single argument n that generates random IDs. A value of NULL defaults to ids::adjective_animal() if available and sample_letters otherwise.

ctor

Function (either a string, a function or number used to index the call stack

ctor_pkg

The package where ctor is defined (either a string or NULL which will use the function environment)

x

Character vector to transform

replace, with

Mapped to base::gsub()

Examples

rand_names()
rand_names(n = 5L)
rand_names(id_fun = sample_letters)