rlib_trace_spec

internal

A toolbox for working with base types, core R features
like the condition system, and core 'Tidyverse' features like tidy
evaluation.

Lionel Henry

rlang

Functions for Base Types and Core R and 'Tidyverse' Features

Hadley Wickham

mikefc 

Yann Collet

Posit, PBC 

rlib_trace_spec function

An r-lib backtrace is a data frame that contains the following
columns:<ul>
<li><code>call</code>: List of calls. These may carry <code>srcref</code> objects.</li>
<li><code>visible</code>: Logical vector. If <code>FALSE</code>, the corresponding call
will be hidden from simplified backtraces.</li>
<li><code>parent</code>: Integer vector of parent references (see
<code><a href="/link/sys.parents()?package=rlang&version=1.1.3" data-mini-rdoc="rlang::sys.parents()">sys.parents()</a></code>) as row numbers. 0 is global.</li>
<li><code>namespace</code>: Character vector of namespaces. <code>NA</code> for global or
no namespace</li>
<li><code>scope</code>: Character vector of strings taking values <code>"::"</code>,
<code>":::"</code>, <code>"global"</code>, or <code>"local"</code>.</li>
</ul>A backtrace data frame may contain extra columns. If you add
additional columns, make sure to prefix their names with the name
of your package or organisation to avoid potential conflicts with
future extensions of this spec, e.g. <code>"mypkg_column"</code>.

Structure

<ul>
<li>Length. The length of the backtrace is the number of rows of
the underlying data.</li>
<li>Concatenation. Performed by row-binding two backtraces. The
<code>parent</code> column of the RHS is shifted by <code>nrow(LHS)</code> so that the
last call of the LHS takes place of the global frame of the RHS.</li>
<li>Subsetting. Performed by slicing the backtrace. After the
data frame is sliced, the <code>parent</code> column is adjusted to the new
row indices. Any <code>parent</code> value that no longer exists in the
sliced backtrace is set to 0 (the global frame).</li>
</ul>

Operations

Backtrace specification — rlib_trace_spec

An r-lib backtrace is a data frame that contains the following
columns:<ul>
<li><code>call</code>: List of calls. These may carry <code>srcref</code> objects.</li>
<li><code>visible</code>: Logical vector. If <code>FALSE</code>, the corresponding call
will be hidden from simplified backtraces.</li>
<li><code>parent</code>: Integer vector of parent references (see
<code><a href='https://rdrr.io/r/base/sys.parent.html'>sys.parents()</a></code>) as row numbers. 0 is global.</li>
<li><code>namespace</code>: Character vector of namespaces. <code>NA</code> for global or
no namespace</li>
<li><code>scope</code>: Character vector of strings taking values <code>"::"</code>,
<code>":::"</code>, <code>"global"</code>, or <code>"local"</code>.</li>
</ul>

A backtrace data frame may contain extra columns. If you add
additional columns, make sure to prefix their names with the name
of your package or organisation to avoid potential conflicts with
future extensions of this spec, e.g. <code>"mypkg_column"</code>.

<ul>
<li>Length. The length of the backtrace is the number of rows of
the underlying data.</li>
<li>Concatenation. Performed by row-binding two backtraces. The
<code>parent</code> column of the RHS is shifted by <code>nrow(LHS)</code> so that the
last call of the LHS takes place of the global frame of the RHS.</li>
<li>Subsetting. Performed by slicing the backtrace. After the
data frame is sliced, the <code>parent</code> column is adjusted to the new
row indices. Any <code>parent</code> value that no longer exists in the
sliced backtrace is set to 0 (the global frame).</li>
</ul>

rlib_trace_spec: Backtrace specification

Description

Arguments

Structure

Operations