string_unfold: Fold and unfold strings
In tabr: Music Notation Syntax, Manipulation, Analysis and Transcription in R

string_unfold

R Documentation

Fold and unfold strings

Description

Fold or unfold a string on the expansion operator.

Usage

string_unfold(x)

string_fold(x, n = 3)

Arguments

`x`	character string, should be valid notes or note info such as beats.
`n`	integer, minimum number of consecutive repeated values to warrant folding, defaults to 3.

Details

These function work on arbitrary stings. They do not perform a noteworthy check. This allows them to work for info strings as well. Make sure your strings are properly formatted. string_fold() always collapses the output string as space-delimited.

Value

character

Examples

time <- "8*3 16 4.. 16 16 2 2 4. 8 4 4 8*4 1"
x <- string_unfold(time)
x
string_fold(x) == time

notes <- "a, b, c d e f g# a r ac'e' a c' e' c' r r r a"
x <- string_fold(notes)
x
string_unfold(x) == notes

tabr documentation built on Sept. 12, 2024, 6:18 a.m.