1.. _module-pw_chrono_stl:
2
3-------------
4pw_chrono_stl
5-------------
6``pw_chrono_stl`` is a collection of ``pw_chrono`` backends that are implemented
7using STL's ``std::chrono`` library.
8
9.. warning::
10  This module is under construction, not ready for use, and the documentation
11  is incomplete.
12
13SystemClock backend
14-------------------
15The STL based ``system_clock`` backend implements the ``pw_chrono:system_clock``
16facade by using the ``std::chrono::steady_clock``. Note that the
17``std::chrono::system_clock`` cannot be used as this is not always a monotonic
18clock source.
19
20See the documentation for ``pw_chrono`` for further details.
21
22Build targets
23-------------
24The GN build for ``pw_chrono_stl`` has one target: ``system_clock``.
25The ``system_clock`` target provides the
26``pw_chrono_backend/system_clock_config.h`` and
27``pw_chrono_backend/system_clock_inline.h`` headers and the backend for the
28``pw_chrono:system_clock``.
29