cast: Cast values into shape

Description Usage Arguments Examples

Description

These functions verify and attempt to coerce values into the specified types and shapes. If they are unsuccessful in the coercion, an error is thrown.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
cast_integer(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_scalar_integer(x, allow_na = FALSE, allow_null = FALSE)

cast_nullable_integer(x, n = NULL, allow_na = FALSE)

cast_nullable_scalar_integer(x, allow_na = FALSE)

cast_integer_list(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_nullable_integer_list(x, n = NULL, allow_na = FALSE)

cast_double(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_scalar_double(x, allow_na = FALSE, allow_null = FALSE)

cast_nullable_double(x, n = NULL, allow_na = FALSE)

cast_nullable_scalar_double(x, allow_na = FALSE)

cast_double_list(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_nullable_double_list(x, n = NULL, allow_na = FALSE)

cast_character(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_scalar_character(x, allow_na = FALSE, allow_null = FALSE)

cast_nullable_character(x, n = NULL, allow_na = FALSE)

cast_nullable_scalar_character(x, allow_na = FALSE)

cast_character_list(x, n = NULL, allow_na = FALSE,
  allow_null = FALSE)

cast_nullable_character_list(x, n = NULL, allow_na = FALSE)

cast_string(x, allow_na = FALSE, allow_null = FALSE)

cast_nullable_string(x, allow_na = FALSE)

cast_string_list(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_nullable_string_list(x, n = NULL, allow_na = FALSE)

cast_logical(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_scalar_logical(x, allow_na = FALSE, allow_null = FALSE)

cast_nullable_logical(x, n = NULL, allow_na = FALSE)

cast_nullable_scalar_logical(x, allow_na = FALSE)

cast_logical_list(x, n = NULL, allow_na = FALSE, allow_null = FALSE)

cast_nullable_logical_list(x, n = NULL, allow_na = FALSE)

cast_choice(x, choices, allow_na = FALSE, allow_null = FALSE)

Arguments

x

A vector.

n

The required length of the vector. If NULL, the length is not checked.

allow_na

Whether to allow NAs in the vector.

allow_null

Whether to allow NULL.

choices

A character, numeric, or integer vector of allowed values.

Examples

1
2
3
4
5
6
7
8
# Cast a double vector to integer
cast_integer(c(1, 2))

# Cast a numeric to a string
cast_string(4.5)

# Cast an integer vector to a list of doubles
cast_double_list(1:4)

kevinykuo/forge documentation built on May 25, 2019, 2:52 a.m.