docs/clang-tidy/checks/bugprone-unused-return-value.rst

.. title:: clang-tidy - bugprone-unused-return-value

bugprone-unused-return-value
============================

Warns on unused function return values. The checked funtions can be configured.

Options
-------

.. option:: CheckedFunctions

   Semicolon-separated list of functions to check. Defaults to
   ``::std::async;::std::launder;::std::remove;::std::remove_if;::std::unique``.
   This means that the calls to following functions are checked by default:

   - ``std::async()``. Not using the return value makes the call synchronous.
   - ``std::launder()``. Not using the return value usually means that the
     function interface was misunderstood by the programmer. Only the returned
     pointer is "laundered", not the argument.
   - ``std::remove()``, ``std::remove_if()`` and ``std::unique()``. The returned
     iterator indicates the boundary between elements to keep and elements to be
     removed. Not using the return value means that the information about which
     elements to remove is lost.