'Rcpp' Bindings to Parser for Tom's Obvious Markup Language

The configuration format defined by 'TOML' (which expands to "Tom's Obvious Markup Language") specifies an excellent format (described at < https://github.com/toml-lang/toml>) suitable for both human editing as well as the common uses of a machine-readable format. This package uses 'Rcpp' to connect the 'cpptoml' parser written by Chase Geigle (in modern C++11) to R.

Rcpp bindings for TOML

TOML is a configuration file grammar for humans. It is easier to read and edit than the alternatives yet arguably more useful as it is stronly types: values come back as integer, double, (multiline-) character (strings), boolean or Datetime. Moreover, complex nesting and arrays are supported as well.

This package uses the C++11 implementation written by Chase Geigle in cpptoml to implement a parser used by R.

The package is now on CRAN and can be installed from every mirror via


Development releases will continue to be provided by the ghrr repository which can accessed using via

## if needed, first do:  install.packages("drat")

Feature-complete with TOML v0.4.0, see the tests/ directory. It parses everything that the underlying cpptoml parses with the same (sole) exception of unicode escape characters in strings.

It does not work on Windows for R as the g++-4.6.2 compiler in Rtools is way too old for the C++11 used by cpptoml.

Dirk Eddelbuettel

GPL (>= 2)


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.1.3 by Dirk Eddelbuettel, 7 months ago


Report a bug at https://github.com/eddelbuettel/rcpptoml/issues

Browse source code at https://github.com/cran/RcppTOML

Authors: Dirk Eddelbuettel

Documentation:   PDF Manual  

GPL (>= 2) license

Imports Rcpp

Linking to Rcpp

System requirements: A C++11 compiler; g++ (>= 4.8.*) should be fine.

Imported by configr.

Suggested by blogdown.

See at CRAN