Skip to contents

Store a cached object in the package storage environment

Source: R/fund_imp.R
store_timeseries.Rd

Evaluate an expression and cache its result in the package storage environment (.fundsr_storage) under a given name. The expression is only re-evaluated when the cached value is missing, when overwrite = TRUE, or when the global option fundsr.reload is TRUE. Optionally merges additional fund/index mappings into .fundsr$fund_index_map.

Usage

store_timeseries(var_name, expr, fund_index_map = NULL, overwrite = FALSE)

Arguments

var_name

Character scalar. Name of the variable to store in .fundsr_storage.

expr

An expression. Evaluated in the caller's environment when (re)computing the cached value.

fund_index_map

Optional named vector or list. Fund/index pairs to merge into .fundsr$fund_index_map. Names are used as keys.

overwrite

Logical scalar. If TRUE, recompute and replace any existing cached value, regardless of fundsr.reload.

Value

Invisibly returns NULL (called for its side effects).

Details

expr is evaluated in the environment where store_timeseries() is called (i.e. the caller's environment), then assigned into .fundsr_storage under var_name.

Caching behavior is controlled by:

  • overwrite = TRUE (always recompute),

  • options(fundsr.reload = TRUE) (force recomputation globally), or

  • absence of var_name in .fundsr_storage (compute once).

If fund_index_map is supplied, it is merged into .fundsr$fund_index_map via name-based assignment: existing entries with the same names are replaced.