8d5327d0aa
At the cost of exposing some existing detail, enable efficient unsharing of graph structure (DeepClone), and efficient ShallowClone. Modify[Key]Values allows in-place modification (or deletion) of node_data in a Map. (the Key is not modified but provided so the modification of the value may depend on the key) UnshareSubtrees for in-place DeepClone copying of shared subtrees. id and hash_value allow creating efficient input Node -> output Node transformations where the result of a previously transformed subtree may be reused (allowing linear time creation of output trees with shared subtrees instead of exponential by Rationale: although YAML::Node faithfully represents the input document and allows efficient traversal, using it as a large-scale configuration / AST means that it's easy to unintentionally create quadratic or worse algorithms modifying the tree. |
||
|---|---|---|
| .github/workflows | ||
| docs | ||
| include/yaml-cpp | ||
| src | ||
| test | ||
| util | ||
| .clang-format | ||
| .codedocs | ||
| .gitignore | ||
| .travis.yml | ||
| appveyor.yml | ||
| BUILD.bazel | ||
| CMakeLists.txt | ||
| CONTRIBUTING.md | ||
| install.txt | ||
| LICENSE | ||
| README.md | ||
| WORKSPACE | ||
| yaml-cpp-config.cmake.in | ||
| yaml-cpp.pc.in | ||
yaml-cpp 
yaml-cpp is a YAML parser and emitter in C++ matching the YAML 1.2 spec.
Usage
See Tutorial and How to Emit YAML for reference. For the old API (until 0.5.0), see How To Parse A Document.
Any Problems?
If you find a bug, post an issue! If you have questions about how to use yaml-cpp, please post it on http://stackoverflow.com and tag it yaml-cpp.
How to Build
yaml-cpp uses CMake to support cross-platform building. Install CMake (Resources -> Download) before proceeding. The basic steps to build are:
Note: If you don't use the provided installer for your platform, make sure that you add CMake's bin folder to your path.
1. Navigate into the source directory, create build folder and run CMake:
mkdir build
cd build
cmake [-G generator] [-DYAML_BUILD_SHARED_LIBS=on|OFF] ..
-
The
generatoroption is the build system you'd like to use. Runcmakewithout arguments to see a full list of available generators.- On Windows, you might use "Visual Studio 12 2013" (VS 2013 32-bits), or "Visual Studio 14 2015 Win64" (VS 2015 64-bits).
- On OS X, you might use "Xcode".
- On a UNIX-like system, omit the option (for a Makefile).
-
yaml-cppbuilds a static library by default, you may want to build a shared library by specifying-DYAML_BUILD_SHARED_LIBS=ON. -
For more options on customizing the build, see the CMakeLists.txt file.
2. Build it!
- The command you'll need to run depends on the generator you chose earlier.
Note: To clean up, just remove the build directory.
Recent Releases
yaml-cpp 0.6.0 released! This release requires C++11, and no longer depends on Boost.
yaml-cpp 0.3.0 is still available if you want the old API.
The old API will continue to be supported, and will still receive bugfixes! The 0.3.x and 0.4.x versions will be old API releases, and 0.5.x and above will all be new API releases.
API Documentation
The autogenerated API reference is hosted on CodeDocs
Third Party Integrations
The following projects are not officially supported: