Skip to main content Module builtins Copy item path Source pub use crate::interpreter::value::BuiltinDescriptor ;pub use crate::interpreter::value::BuiltinFn ;pub use crate::interpreter::value::BuiltinImplementation ;pub use crate::interpreter::value::InterpreterBuiltinFn ;pub use crate::interpreter::value::PreEvalBuiltinFn ;args 🔒 Shared decoding helpers for builtin positional and named arguments. coercion 🔒 Coercion builtins: as.integer, as.double, as.character, etc. collections Rust std::collections exposed as R data structures. conditions 🔒 R condition system builtins — stop, warning, message, signalCondition,
condition constructors, condition accessors, and restart invocation. connections Connection object builtins — file connections, stdin/stdout/stderr, TCP sockets. dataframes 🔒 Data frame manipulation builtins — merge, subset, transform, with. datetime 🔒 Date and time builtins: Sys.Date, as.Date, as.POSIXct, format.Date, etc. digest 🔒 Cryptographic digest builtins (SHA-256, SHA-512, BLAKE3, CRC32). factors 🔒 Factor builtins — factor construction, levels, and nlevels. graphics Graphics builtins — high-level R plotting functions that accumulate
PlotItems in the interpreter’s PlotState, then display via
egui_plot (when the plot feature is enabled) or print a helpful
message (when it is not). grid Grid graphics builtins — R-facing functions for the grid graphics system. interp 🔒 Interpreter-level builtins — functions that receive BuiltinContext so
they can call back into the active interpreter without direct TLS lookups.
Each is auto-registered via #[interpreter_builtin]. io File I/O builtins — reading and writing data files (CSV, table, lines, scan)
and file system utilities (file.path, file.exists). json 🔒 JSON builtins — fromJSON() and toJSON() providing jsonlite-compatible
conversion between R values and JSON strings. math native_code 🔒 Native code builtins — .Call(), dyn.load(), dyn.unload(), etc. net 🔒 HTTP/HTTPS networking builtins — download.file() and url(). parquet 🔒 Parquet I/O builtins — read.parquet() and write.parquet() for reading
and writing Apache Parquet files as data frames. pre_eval 🔒 Pre-eval builtins — functions that intercept before argument evaluation.
Each is auto-registered via #[pre_eval_builtin].
The interpreter is accessed via the BuiltinContext passed at dispatch time. progress Text progress bar builtins backed by the indicatif crate. random 🔒 Random number generation builtins: set.seed, runif, rnorm, rbinom, sample, etc.
Uses the per-interpreter RNG state via BuiltinContext. rlang_ffi s4 🔒 S4 OOP system — class registry, method dispatch, and object construction. serialize GNU R serialization — reading and writing RDS files. stats 🔒 Statistics builtins: cor, cov, weighted.mean, scale, complete.cases, na.omit,
and distribution functions (d/p/q for norm, unif, exp, gamma, beta, cauchy,
weibull, lnorm, chisq, t, f, binom, pois, geom, hyper). strings stubs 🔒 Stub builtins — not-yet-implemented functions that return sensible defaults
or fail explicitly. Also includes lightweight implementations of commonly
needed functions that don’t warrant their own module. system System, file, directory, path, and temp builtins. tables 🔒 Table and tabulate builtins — contingency tables and integer bin counting. tables_display 🔒 Rich table display builtins using the tabled crate. toml 🔒 TOML builtins — read.toml(), write.toml(), toml_parse(), and toml_serialize()
for reading, writing, and converting between R values and TOML. types 🔒 Type-checking builtins: is.null, is.na, is.numeric, etc. BindInput 🔒 BUILTIN_REGISTRY __BUILTIN_REG_BUILTIN_ALL 🔒 __BUILTIN_REG_BUILTIN_ALL_EQUAL 🔒 __BUILTIN_REG_BUILTIN_ANY 🔒 __BUILTIN_REG_BUILTIN_ANY_DUPLICATED 🔒 __BUILTIN_REG_BUILTIN_APERM 🔒 __BUILTIN_REG_BUILTIN_ARGS 🔒 __BUILTIN_REG_BUILTIN_ARRAY 🔒 __BUILTIN_REG_BUILTIN_ASIS 🔒 __BUILTIN_REG_BUILTIN_AS_FUNCTION 🔒 __BUILTIN_REG_BUILTIN_AS_FUNCTION_DEFAULT 🔒 __BUILTIN_REG_BUILTIN_ATTR 🔒 __BUILTIN_REG_BUILTIN_ATTRIBUTES 🔒 __BUILTIN_REG_BUILTIN_ATTR_SET 🔒 __BUILTIN_REG_BUILTIN_BODY 🔒 __BUILTIN_REG_BUILTIN_BODY_SET 🔒 __BUILTIN_REG_BUILTIN_C 🔒 __BUILTIN_REG_BUILTIN_CALL 🔒 __BUILTIN_REG_BUILTIN_CBIND 🔒 __BUILTIN_REG_BUILTIN_CHARACTER 🔒 __BUILTIN_REG_BUILTIN_CHARMATCH 🔒 __BUILTIN_REG_BUILTIN_CLASS 🔒 __BUILTIN_REG_BUILTIN_CLASS_SET 🔒 __BUILTIN_REG_BUILTIN_COL_NAMES 🔒 __BUILTIN_REG_BUILTIN_COL_NAMES_SET 🔒 __BUILTIN_REG_BUILTIN_CUT 🔒 __BUILTIN_REG_BUILTIN_DIM 🔒 __BUILTIN_REG_BUILTIN_DIMNAMES 🔒 __BUILTIN_REG_BUILTIN_DIMNAMES_SET 🔒 __BUILTIN_REG_BUILTIN_DIM_SET 🔒 __BUILTIN_REG_BUILTIN_DUPLICATED 🔒 __BUILTIN_REG_BUILTIN_ENVIRONMENT_NAME 🔒 __BUILTIN_REG_BUILTIN_ENVIRONMENT_SET 🔒 __BUILTIN_REG_BUILTIN_EXPAND_GRID 🔒 __BUILTIN_REG_BUILTIN_FIND_INTERVAL 🔒 __BUILTIN_REG_BUILTIN_FORCE 🔒 __BUILTIN_REG_BUILTIN_FORMALS 🔒 __BUILTIN_REG_BUILTIN_FORMALS_SET 🔒 __BUILTIN_REG_BUILTIN_GC 🔒 __BUILTIN_REG_BUILTIN_GCINFO 🔒 __BUILTIN_REG_BUILTIN_IDENTICAL 🔒 __BUILTIN_REG_BUILTIN_IDENTITY 🔒 __BUILTIN_REG_BUILTIN_IFELSE 🔒 __BUILTIN_REG_BUILTIN_INHERITS 🔒 __BUILTIN_REG_BUILTIN_INTEGER 🔒 __BUILTIN_REG_BUILTIN_INTERSECT 🔒 __BUILTIN_REG_BUILTIN_ISDEBUGGED 🔒 __BUILTIN_REG_BUILTIN_LENGTH 🔒 __BUILTIN_REG_BUILTIN_LIST 🔒 __BUILTIN_REG_BUILTIN_LOGICAL 🔒 __BUILTIN_REG_BUILTIN_MATCH 🔒 __BUILTIN_REG_BUILTIN_MATCH_ARG 🔒 __BUILTIN_REG_BUILTIN_MATRIX 🔒 __BUILTIN_REG_BUILTIN_MODE 🔒 __BUILTIN_REG_BUILTIN_MODIFY_LIST 🔒 __BUILTIN_REG_BUILTIN_NAMES 🔒 __BUILTIN_REG_BUILTIN_NAMES_SET 🔒 __BUILTIN_REG_BUILTIN_NCHAR 🔒 __BUILTIN_REG_BUILTIN_NCOL 🔒 __BUILTIN_REG_BUILTIN_NCOL_SAFE 🔒 __BUILTIN_REG_BUILTIN_NEW_ENV 🔒 __BUILTIN_REG_BUILTIN_NROW 🔒 __BUILTIN_REG_BUILTIN_NROW_SAFE 🔒 __BUILTIN_REG_BUILTIN_NUMERIC 🔒 __BUILTIN_REG_BUILTIN_OLD_CLASS 🔒 __BUILTIN_REG_BUILTIN_OLD_CLASS_SET 🔒 __BUILTIN_REG_BUILTIN_PAIRLIST 🔒 __BUILTIN_REG_BUILTIN_PARENT_ENV 🔒 __BUILTIN_REG_BUILTIN_PARENT_ENV_SET 🔒 __BUILTIN_REG_BUILTIN_PASTE 🔒 __BUILTIN_REG_BUILTIN_PASTE0 🔒 __BUILTIN_REG_BUILTIN_PMATCH 🔒 __BUILTIN_REG_BUILTIN_Q 🔒 __BUILTIN_REG_BUILTIN_RBIND 🔒 __BUILTIN_REG_BUILTIN_REPLACE 🔒 __BUILTIN_REG_BUILTIN_ROW_NAMES 🔒 __BUILTIN_REG_BUILTIN_ROW_NAMES_SET 🔒 __BUILTIN_REG_BUILTIN_R_VERSION 🔒 __BUILTIN_REG_BUILTIN_SETDIFF 🔒 __BUILTIN_REG_BUILTIN_STOPIFNOT 🔒 __BUILTIN_REG_BUILTIN_STRUCTURE 🔒 __BUILTIN_REG_BUILTIN_SYS_LOCALECONV 🔒 __BUILTIN_REG_BUILTIN_TYPEOF 🔒 __BUILTIN_REG_BUILTIN_UNCLASS 🔒 __BUILTIN_REG_BUILTIN_UNDEBUG 🔒 __BUILTIN_REG_BUILTIN_UNION 🔒 __BUILTIN_REG_BUILTIN_UNLIST 🔒 __BUILTIN_REG_BUILTIN_UNNAME 🔒 __BUILTIN_REG_BUILTIN_USE_METHOD 🔒 __BUILTIN_REG_BUILTIN_VECTOR 🔒 __BUILTIN_REG_BUILTIN_XOR 🔒 __INTERP_REG_BUILTIN_CAT 🔒 __INTERP_REG_INTERP_BROWSER 🔒 __INTERP_REG_INTERP_DEBUG 🔒 __INTERP_REG_INTERP_DETACH 🔒 __INTERP_REG_INTERP_GETWD 🔒 __INTERP_REG_INTERP_HELP 🔒 __INTERP_REG_INTERP_LOAD_NAMESPACE 🔒 __INTERP_REG_INTERP_READLINE 🔒 __INTERP_REG_INTERP_REQUIRE_NAMESPACE 🔒 __INTERP_REG_INTERP_STR 🔒 __INTERP_REG_INTERP_SYS_GETENV 🔒 __INTERP_REG_INTERP_TRACEBACK 🔒 all_equal_attrs 🔒 Compare attributes of two objects. all_equal_character 🔒 Compare character vectors element-wise. all_equal_lists 🔒 Compare two lists recursively. all_equal_names_attr 🔒 Check only the “names” attribute. all_equal_numeric 🔒 Compare numeric vectors using R’s mean relative/absolute difference. all_equal_recurse 🔒 Recursively compare two R values, collecting difference messages. all_equal_vectors 🔒 Compare two vectors, collecting difference messages. as_function_impl 🔒 attrs_identical 🔒 Compare two attribute maps for identical-ness. automatic_row_names_value 🔒 bind_dimnames_value 🔒 builtin_all 🔒 Test if all values are TRUE. builtin_all_equal 🔒 Test near-equality of two objects within a tolerance. builtin_any 🔒 Test if any values are TRUE. builtin_any_duplicated 🔒 anyDuplicated(x) — index of first duplicate, or 0 if none.builtin_aperm 🔒 Transpose or permute the dimensions of an array. builtin_args 🔒 args(fn) — return the formals of a function (simplified: same as formals).
In GNU R, args() returns a function with the same formals but NULL body.
We simplify to just returning formals, which covers all practical uses.builtin_array 🔒 Create a multi-dimensional array. builtin_as_function 🔒 as.function(x, envir) — convert a list to a function.builtin_as_function_default 🔒 as.function.default — same as as.function, dispatched for default method.builtin_asis 🔒 I(x) — mark an object as “AsIs”, inhibiting conversion.builtin_attr 🔒 Get a single attribute of an object. builtin_attr_set 🔒 Set a single attribute on an object. builtin_attributes 🔒 Get all attributes of an object as a named list. builtin_body 🔒 body(fn) — return the body of a function as a Language object.
For closures, returns the body expression. For builtins, returns NULL.builtin_body_set 🔒 body<-(fn, value) — set the body of a closure.builtin_c Combine values into a vector or list. builtin_call 🔒 call(name, ...) — construct an unevaluated function call expression.
call("f", 1, 2) returns the language object f(1, 2).builtin_cat 🔒 Concatenate and print objects to stdout. builtin_cbind 🔒 Bind vectors, matrices, or data frames by columns. builtin_character 🔒 Create a character vector of empty strings with the given length. builtin_charmatch 🔒 Character partial matching — like pmatch but returns 0 for ambiguous matches. builtin_class 🔒 Get the class of an object. builtin_class_set 🔒 Set the class attribute of an object. builtin_col_names 🔒 Get the column names of a data frame or matrix. builtin_col_names_set 🔒 Set the column names of a data frame or matrix. builtin_cut 🔒 Bin continuous values into intervals, returning a factor with interval labels. builtin_dim 🔒 Get the dimensions of a matrix, array, or data frame. builtin_dim_set 🔒 Set the dimensions of an object, converting it to a matrix or array. builtin_dimnames 🔒 Get the dimension names of a matrix, array, or data frame. builtin_dimnames_set 🔒 Set the dimension names of a matrix, array, or data frame. builtin_duplicated 🔒 Identify duplicate elements in a vector. builtin_environment_name 🔒 Get the name of an environment. builtin_environment_set 🔒 environment<-(fn, value) — set the environment of a closure.builtin_expand_grid 🔒 Create a data frame from all combinations of the supplied vectors. builtin_find_interval 🔒 Find the interval index containing each element of x. builtin_force 🔒 Return its argument unchanged. Forces evaluation of a promise.
@param x any R value
@return x, unchanged builtin_formals 🔒 formals(fn) — return the formal parameter list of a function as a named list.builtin_formals_set 🔒 formals<-(fn, value) — set the formals of a closure.builtin_gc 🔒 Trigger garbage collection (stub). builtin_gcinfo 🔒 Set or query verbose GC reporting (stub). builtin_identical 🔒 Test if two objects are exactly identical. builtin_identity 🔒 Return its argument unchanged (identity function).
@param x any R value
@return x, unchanged builtin_ifelse 🔒 Vectorized conditional: for each element of test, select the corresponding
element from yes (when TRUE) or no (when FALSE). yes and no are recycled
to the length of test. builtin_inherits 🔒 Test if an object inherits from one or more classes. builtin_integer 🔒 Create an integer vector of zeros with the given length. builtin_intersect 🔒 Set intersection: elements present in both x and y. builtin_isdebugged 🔒 Query whether a function has debug-mode enabled (stub). builtin_length 🔒 Get the length of an object. builtin_list 🔒 Construct a list from the given arguments. builtin_logical 🔒 Create a logical vector of FALSE values with the given length. builtin_match 🔒 Find positions of first matches of x in table. builtin_match_arg 🔒 Match an argument to a set of candidate values. builtin_matrix 🔒 Create a matrix from the given data. builtin_mode 🔒 Get the mode (storage type) of an object. builtin_modify_list 🔒 Modify a list by replacing/adding/removing elements from another list. builtin_names 🔒 Get the names attribute of an object. builtin_names_set 🔒 Set the names attribute of an object. builtin_nchar 🔒 Count the number of characters in each element of a character vector. builtin_ncol 🔒 Get the number of columns of a matrix, array, or data frame. builtin_ncol_safe 🔒 Get the number of columns, treating non-matrix vectors as 1-column. builtin_new_env 🔒 Create a new environment. builtin_nrow 🔒 Get the number of rows of a matrix, array, or data frame. builtin_nrow_safe 🔒 Get the number of rows, treating non-matrix vectors as 1-column matrices. builtin_numeric 🔒 Create a double vector of zeros with the given length. builtin_old_class 🔒 Get the class attribute of an object (S3 compat alias for class()).
@param x any R value
@return class attribute or NULL
@namespace base builtin_old_class_set 🔒 Set the old-style (S3) class attribute — alias for class<-.
@param x object
@param value class names or NULL
@return modified object
@namespace base builtin_pairlist 🔒 Create a pairlist from named arguments. builtin_parent_env 🔒 Get the parent (enclosing) environment of an environment. builtin_parent_env_set 🔒 Set the parent (enclosing) environment. builtin_paste 🔒 Concatenate strings with a separator. builtin_paste0 🔒 Concatenate strings with no separator. builtin_pmatch 🔒 Partial string matching — find unique partial matches of x in table. builtin_q 🔒 Terminate the R session. builtin_r_version 🔒 Get the version of the R implementation. builtin_rbind 🔒 Bind vectors, matrices, or data frames by rows. builtin_replace 🔒 Replace values in a vector at specified indices. builtin_row_names 🔒 Get the row names of a data frame or matrix. builtin_row_names_set 🔒 Set the row names of a data frame or matrix. builtin_setdiff 🔒 Set difference: elements in x that are not in y. builtin_stopifnot 🔒 Assert that all arguments are TRUE, stopping with an error otherwise. builtin_structure 🔒 Set attributes on an object in a single call. builtin_sys_localeconv 🔒 Return locale-specific numeric formatting conventions. builtin_typeof 🔒 Get the internal type of an object. builtin_unclass 🔒 Remove the class attribute from an object. builtin_undebug 🔒 Remove debug-mode single-stepping from a function (stub). builtin_union 🔒 Set union: unique elements from both x and y. builtin_unlist 🔒 Flatten a list into an atomic vector. builtin_unname 🔒 Remove names and dimnames from an object. builtin_use_method 🔒 UseMethod() is intercepted directly by the evaluator so it can unwind the
current generic frame instead of returning like an ordinary builtin.builtin_vector 🔒 Create a vector of a given mode and length. builtin_xor 🔒 Vectorized exclusive OR. cbind_data_frames 🔒 Column-bind data frames. character_name_vector 🔒 coerce_name_strings 🔒 coerce_name_values 🔒 collect_c_names 🔒 Collect element names for c(): named arguments provide names for scalars,
existing names attributes provide names for vector elements. collect_list_elements_recursive 🔒 Recursively collect all non-list elements from a list and its nested sublists. combine_expand_grid_column 🔒 Combine a column of scalar RValues back into a single typed vector. concat_column_values 🔒 Concatenate column values from multiple data frames into a single column. data_frame_dimnames_value 🔒 data_frame_row_count 🔒 dimnames_component 🔒 empty_expand_grid 🔒 Return an empty data.frame for expand.grid with zero-length inputs. extract_param_names_from_doc 🔒 Extract parameter names from a doc string’s @param name ... lines. find_builtin Look up a builtin descriptor by R name or alias. find_builtin_ns Look up a builtin by namespace::name (e.g. “stats::cor”). format_help Format a builtin’s doc string for display.
Convention: first line = title, rest = description/params. format_r_double_cut 🔒 Format a double for cut() labels — avoid trailing zeros but keep precision. generate_rd_docs Generate .Rd documentation files for all documented builtins. get_dim_ints 🔒 Extract integer dim values from a dim attribute has_class 🔒 interp_browser 🔒 Enter the browser for interactive debugging (stub). interp_debug 🔒 Set a function for debug-mode single-stepping (stub). interp_detach 🔒 Detach a package from the search path. interp_getwd 🔒 Get the interpreter’s current working directory. interp_help 🔒 Display help for a function. interp_load_namespace 🔒 Load a package namespace without attaching it to the search path. interp_readline 🔒 Read a line of user input from stdin. interp_require_namespace 🔒 Check if a namespace can be loaded, returning TRUE/FALSE. interp_str 🔒 Display the compact internal structure of an object. interp_sys_getenv 🔒 Get environment variable(s) from the interpreter’s environment. interp_traceback 🔒 Print the call stack of the last error. list_names_value 🔒 math_unary_op Helper for unary math builtins: applies f64 -> f64 element-wise. r_identical 🔒 Deep structural comparison of two R values. rbind_data_frames 🔒 Row-bind data frames by matching column names. register_builtin_binding 🔒 register_builtins register_operator_builtins 🔒 Register R’s primitive operators as first-class callable functions. rvalue_to_expr 🔒 Convert an RValue back to an AST expression (for call/expression construction). sanitize_rd_filename 🔒 Sanitize a builtin name for use as a filename. set_data_frame_col_names 🔒 set_data_frame_dimnames 🔒 set_data_frame_row_names 🔒 set_key 🔒 Canonical string key for set operations — works across numeric and character types. set_list_names 🔒 set_op_extract 🔒 Determine whether set operations should work in numeric or character mode.
Returns the result type based on input types: numeric inputs stay numeric. set_result_numeric 🔒 Reconstruct a numeric vector from character representations produced by set operations. str_format_element 🔒 Format one element for str() output (used for list elements).
Returns a one-line summary: “ type [1:len] preview“ for vectors,
“List of N” for nested lists, etc. str_vector_preview 🔒 Format a vector element preview for str() output (first 10 elements). synthesize_builtin_help Synthesize RdDoc help pages from all builtin descriptors and register
them in the help index. This gives every builtin a rich help page
(title, usage, arguments, return value) derived from rustdoc comments. updated_dimnames_component 🔒 vector_to_items 🔒 Extract scalar items from an RValue for expand.grid column construction. vectors_identical 🔒 Element-wise comparison of two atomic vectors.