diff --git a/clang-tools-extra/clang-tidy/readability/ContainerSizeEmptyCheck.h b/clang-tools-extra/clang-tidy/readability/ContainerSizeEmptyCheck.h index 3aa4bdc496194..e449686f77566 100644 --- a/clang-tools-extra/clang-tidy/readability/ContainerSizeEmptyCheck.h +++ b/clang-tools-extra/clang-tidy/readability/ContainerSizeEmptyCheck.h @@ -19,10 +19,10 @@ namespace clang::tidy::readability { /// /// The emptiness of a container should be checked using the `empty()` method /// instead of the `size()`/`length()` method. It shows clearer intent to use -/// `empty()`. Furthermore some containers may implement the `empty()` method -/// but not implement the `size()` or `length()` method. Using `empty()` -/// whenever possible makes it easier to switch to another container in the -/// future. +/// `empty()`. Furthermore some containers (for example, a `std::forward_list`) +/// may implement the `empty()` method but not implement the `size()` or +/// `length()` method. Using `empty()` whenever possible makes it easier to +/// switch to another container in the future. class ContainerSizeEmptyCheck : public ClangTidyCheck { public: ContainerSizeEmptyCheck(StringRef Name, ClangTidyContext *Context); diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/container-size-empty.rst b/clang-tools-extra/docs/clang-tidy/checks/readability/container-size-empty.rst index 6a007f69767ab..43ad74f60dbe5 100644 --- a/clang-tools-extra/docs/clang-tidy/checks/readability/container-size-empty.rst +++ b/clang-tools-extra/docs/clang-tidy/checks/readability/container-size-empty.rst @@ -9,9 +9,10 @@ with a call to ``empty()``. The emptiness of a container should be checked using the ``empty()`` method instead of the ``size()``/``length()`` method. It shows clearer intent to use -``empty()``. Furthermore some containers may implement the ``empty()`` method -but not implement the ``size()`` or ``length()`` method. Using ``empty()`` -whenever possible makes it easier to switch to another container in the future. +``empty()``. Furthermore some containers (for example, a ``std::forward_list``) +may implement the ``empty()`` method but not implement the ``size()`` or +``length()`` method. Using ``empty()`` whenever possible makes it easier to +switch to another container in the future. The check issues warning if a container has ``empty()`` and ``size()`` or ``length()`` methods matching following signatures: