validate_table_struct: Validate and assert valid table structure

In Roche/rtables: Reporting Tables

Validate and assert valid table structure

Description

A TableTree (rtables-built table) is considered degenerate if:

1. It contains no subtables or data rows (content rows do not count).

2. It contains a subtable which is degenerate by the criterion above.

validate_table_struct assesses whether tt has a valid (non-degenerate) structure.

assert_valid_table asserts a table must have a valid structure, and throws an informative error (the default) or warning (if warn_only is TRUE) if the table is degenerate (has invalid structure or contains one or more invalid substructures.

Usage

validate_table_struct(tt)

assert_valid_table(tt, warn_only = FALSE)

Arguments

tt	(TableTree) a TableTree object.
warn_only	(flag) whether a warning should be thrown instead of an error. Defaults to FALSE.

Value

• validate_table_struct returns a logical value indicating valid structure.

• assert_valid_table is called for its side-effect of throwing an error or warning for degenerate tables.

Note

This function is experimental and the exact text of the warning/error is subject to change in future releases.

See Also

Other table structure validation functions: find_degen_struct(), sanitize_table_struct()

Examples

validate_table_struct(rtable("hahaha"))
## Not run: 
assert_valid_table(rtable("oops"))

## End(Not run)

Roche/rtables documentation built on April 30, 2024, 11:18 p.m.