Vector Helpers
Overview
Defines new notions of prototype and size that are used to provide tools for consistent and well-founded type-coercion and size-recycling, and are in turn connected to ideas of type- and size-stability useful for analysing function interfaces.
- Experimentally turned
KeepSource: trueon inDESCRIPTION. - Fixed an accidental usage of non-API
PRVALUE()(#2165).
From NEWS.md in the release
Install
Health
ERRORre-building of vignette outputsr-release-macos-x86_64
Error(s) in re-building vignettes: --- re-building ‘pillar.Rmd’ using rmarkdown Error: processing vignette 'pillar.Rmd' failed with diagnostics: there is no package called ‘sass’ --- failed re-building ‘pillar.Rmd’ --- re-building ‘s3-vector.Rmd’ using rmarkdown Error: processing vignette 's3-vector.Rmd' failed with diagnostics: there is no package called ‘sass’ --- failed re-building ‘s3-vector.Rmd’ --- re-building ‘stability.Rmd’ using rmarkdown Error: processing vignette 'stability.Rmd' failed with diagnostics: there is no package called ‘sass’ --- failed re-building ‘stability.Rmd’ --- re-building ‘type-size.Rmd’ using rmarkdown Error: processing vignette 'type-size.Rmd' failed with diagnostics: there is no package called ‘sass’ --- failed re-building ‘type-size.Rmd’ SUMMARY: processing the following files failed: ‘pillar.Rmd’ ‘s3-vector.Rmd’ ‘stability.Rmd’ ‘type-size.Rmd’ Error: Vignette re-building failed. Execution halted
NOTEcompiled coder-oldrel-macos-arm64, r-oldrel-macos-x86_64, r-oldrel-windows-x86_64
r-oldrel-macos-arm64, r-oldrel-macos-x86_64
File ‘vctrs/libs/vctrs.so’:
Found non-API calls to R: ‘PRENV’, ‘PRVALUE’, ‘R_PromiseExpr’,
‘Rf_allocSExp’, ‘Rf_findVarInFrame3’, ‘SETLENGTH’,
‘SET_GROWABLE_BIT’, ‘SET_PRCODE’, ‘SET_PRENV’, ‘SET_PRVALUE’,
‘SET_TRUELENGTH’
Compiled code should not call non-API entry points in R.
See ‘Writing portable packages’ in the ‘Writing R Extensions’ manual,
and section ‘Moving into C API compliance’ for issues with the use of
non-API entry points.r-oldrel-windows-x86_64
File 'vctrs/libs/x64/vctrs.dll':
Found non-API calls to R: 'PRENV', 'PRVALUE', 'R_PromiseExpr',
'Rf_allocSExp', 'Rf_findVarInFrame3', 'SETLENGTH',
'SET_GROWABLE_BIT', 'SET_PRCODE', 'SET_PRENV', 'SET_PRVALUE',
'SET_TRUELENGTH'
Compiled code should not call non-API entry points in R.
See 'Writing portable packages' in the 'Writing R Extensions' manual,
and section 'Moving into C API compliance' for issues with the use of
non-API entry points.NOTERd contentsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc
Rd files without \usage: ‘name_spec.Rd’ \arguments should not be documented without \usage.
- ERROR7 OK, 5 NOTE, 1 ERRORNow
- ERROR9 OK, 3 NOTE, 1 ERROR2026-05-02
- NOTE9 OK, 4 NOTE2026-04-30
- ERROR8 OK, 4 NOTE, 1 ERROR2026-04-28
- NOTE8 OK, 6 NOTE2026-04-15
- ERROR5 OK, 8 NOTE, 1 ERROR2026-03-30
Show 4 earlier changesHide 4 earlier changes
- NOTE7 OK, 7 NOTE2026-03-28
- ERROR7 OK, 6 NOTE, 1 ERROR2026-03-26
- WARNING2 OK, 7 NOTE, 5 WARNING2026-03-21
- ERROR2 OK, 6 NOTE, 5 WARNING, 1 ERROR2026-03-10
Documentation
- Help pages
- 99 (41 internal)includes a package overview page
- Examples that run
- 100%61 run in a plain check
- Exported functions with examples
- 70%
- Documented parameters
- 80%
- Return-value docs
- 54%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 89%
- Median days to close, 50 most recently updated closed issues
- 70
- Median days to close, 50 most recently updated closed PRs
- 1
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
14 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/r-lib/vctrs on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-04-17 · The repository has a site deploy workflow
pkgdown site last built 2026-04-17
Show all practicesHide 3 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2025-12-19Seen in the repository: .claude, .claude/skillsNamed in .Rbuildignore: .claude
Dependencies
Installing vctrs adds 4 packages (3 with compiled code, 1.6 MB of source tarballs). Heaviest: rlang 766 KB, cli 629 KB, glue 127 KB.
Show the 48 most downloaded dependentsHide the 48 most downloaded dependents
and 332 more dependents and 80 packages that suggest it on CRAN ↗
Code & Tests
People & History
Previously maintained by Lionel Henry (0.3.1 to 0.5.2) and Hadley Wickham (0.1.0 to 0.3.0).
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 0.7.3Latest
- 0.7.22026-01-23 · diff ↗
- 0.7.12026-01-23 · diff ↗
- 0.7.02026-01-16 · diff ↗ ·
removed 4 exports
is_partial, new_partial, partial_factor, partial_frameadded 14 exports
list_all_recyclable, list_check_all_recyclable, list_combine, list_of_ptype, list_of_size, list_of_transpose, vec_case_when, vec_check_recyclable, vec_if_else, vec_pall, vec_pany, vec_recode_values, vec_replace_values, vec_replace_when - RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 0.6.52023-12-02 · diff ↗
- 0.6.42023-10-13 · diff ↗
- 0.6.32023-06-15 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 0.6.22023-04-19 · diff ↗
- 0.6.12023-03-22 · diff ↗
- 0.6.02023-03-16 · diff ↗ ·
added 6 exports
obj_check_list, obj_check_vector, obj_is_list, obj_is_vector, vec_check_size, vec_run_sizes - 0.5.22023-01-23 · diff ↗ ·
added 5 exports
vec_expand_grid, vec_set_difference, vec_set_intersect, vec_set_symmetric_difference, vec_set_union - 0.5.12022-11-16 · diff ↗
Show 24 earlier eventsHide 24 earlier events
- 0.5.02022-10-22 · diff ↗ ·
removed 2 exports
validate_list_of, vec_list_castadded 6 exports
list_all_size, list_check_all_size, list_unchop, vec_any_missing, vec_detect_missing, vec_rank - 0.4.22022-09-29 · diff ↗
- RR 4.2.0 released · 2022-04-22
- 0.4.12022-04-13 · diff ↗
- 0.4.02022-03-30 · diff ↗ ·
added 7 exports
list_all_vectors, list_check_all_vectors, list_drop_empty, vec_check_list, vec_interleave, vec_locate_matches, vec_locate_sorted_groups - RR 4.1.0 released · 2021-05-18
- 0.3.82021-04-29 · diff ↗
- 0.3.7
- 0.3.62020-12-17 · diff ↗
- 0.3.5
- 0.3.42020-08-29 · diff ↗
- 0.3.32020-08-28 · diff ↗ ·
removed 2 exports
vec_cast.table, vec_ptype2.tableadded 3 exports
data_frame, df_list, vec_proxy_order - 0.3.2
- 0.3.12020-06-05 · diff ↗
- 0.3.02020-05-12 · diff ↗ ·
removed 2 exports
vec_ptype2.POSIXt, vec_ptype2.vctrs_unspecifiedadded 15 exports
df_cast, df_ptype2, list_sizes, tib_cast, tib_ptype2, vec_arith.POSIXlt, vec_cast.ordered, vec_cast.table, vec_cbind_frame_ptype, vec_ptype2.AsIs, vec_ptype2.POSIXct, vec_ptype2.POSIXlt, vec_ptype2.table, vec_rep, vec_rep_each - RR 4.0.0 released · 2020-04-24
- 0.2.4
- 0.2.3
- 0.2.22020-01-24 · diff ↗ ·
removed 1 export
%<-%added 11 exports
num_as_location, num_as_location2, vec_as_location, vec_as_location2, vec_as_subscript, vec_as_subscript2, vec_chop, vec_group_id, vec_group_loc, vec_group_rle, vec_ptype2.complex - 0.2.12019-12-17 · diff ↗
- 0.2.02019-07-06 · diff ↗ ·
removed 20 exports
vec_dim, vec_dims, vec_na, vec_type2.Date, vec_type2.POSIXt, vec_type2.character, vec_type2.data.frame, vec_type2.difftime, vec_type2.double, vec_type2.factor, vec_type2.integer, vec_type2.list, vec_type2.logical, vec_type2.ordered, vec_type2.tbl_df, vec_type2.vctrs_list_of, vec_type2.vctrs_unspecified, vec_type_finalise, vec_unspecified_cast, warn_lossy_castadded 43 exports
allow_lossy_cast, maybe_lossy_cast, partial_factor, stop_incompatible_size, validate_list_of, vec_as_index, vec_as_names, vec_as_names_legacy, vec_assign, vec_cast.complex, vec_cast.integer64, vec_cast.raw, vec_default_cast, vec_default_ptype2, vec_init, vec_init_along, vec_is, vec_is_empty, vec_order, vec_proxy, vec_ptype2, vec_ptype2.Date, vec_ptype2.POSIXt, vec_ptype2.character, vec_ptype2.data.frame, vec_ptype2.difftime, vec_ptype2.double, vec_ptype2.factor, vec_ptype2.integer, vec_ptype2.integer64 and 13 more - RR 3.6.0 released · 2019-04-26
- 0.1.02018-11-29
- RR 3.5.0 released · 2018-04-23
Package metadata
- First published
- 2018-11-29
- Total releases
- 31 / 8 yrs
- License
- MIT + file LICENSE OSI · relicensed from GPL-3 in 0.3.5
- Minimum R
- ≥ 4.0.0
- Download size
- 1.0 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("vctrs")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.