From 12e47bd5b5f23beb46711f10498052e6d3b83699 Mon Sep 17 00:00:00 2001 From: Daniel <d.hornung@indiscale.com> Date: Wed, 18 Aug 2021 09:42:58 +0200 Subject: [PATCH] DOC: SKIP_LINTING and deleted Property copy constructor. --- README_SETUP.md | 2 ++ include/caosdb/entity.h | 10 ++++++++++ 2 files changed, 12 insertions(+) diff --git a/README_SETUP.md b/README_SETUP.md index 147745c..f73190c 100644 --- a/README_SETUP.md +++ b/README_SETUP.md @@ -77,6 +77,8 @@ For the tests there is a slightly different setup required (with option `-D CMAK 1. `mkdir build && cd build/` 2. `conan install .. -s "compiler.libcxx=libstdc++11"` 3. `cmake -B . -D CMAKE_BUILD_TYPE=Debug ..` + * If your clang-format version is too old, formatting, linting etc. can be skipped: + `cmake -B . -D CMAKE_BUILD_TYPE=Debug -D SKIP_LINTING=ON ..` 4. `cmake --build .` ### Run diff --git a/include/caosdb/entity.h b/include/caosdb/entity.h index a96126e..8d3aeb9 100644 --- a/include/caosdb/entity.h +++ b/include/caosdb/entity.h @@ -558,6 +558,16 @@ private: * Container for Properties of Entities. * * Should only be instantiated and write-accessed by the owning entity. + * + * Note that iterating over the Property contents only works via references, since the Property copy + * constructor is deliberately disabled: + * + * \code + * // Accessing single properties as reference + * auto &property = my_properties.at(0); + * // Iterating via reference + * for (auto &property : my_properties) {...} + * \endcode */ class Properties : public RepeatedPtrFieldWrapper<Property, -- GitLab