Files
=====

.. toctree::
   :maxdepth: 2
   :caption: Contents:

Including Header Files
----------------------

:rule:`FILE-000` The style used to specify an include shall reflect the locality of the included
header file.

- All includes which are part of the same module shall use quotes ``""``.
- All includes which are not part of the same module (including system headers) shall use angle
  brackets ``<>``.

Standard Headers
----------------

- See `C++ Standard Library headers <https://en.cppreference.com/w/cpp/header>`_ for details.
  Note, that not all includes make sense in embedded code. Some parts are replaced by our own
  ``estd`` library.
- :rule:`FILE-010` If a file needs to be compiled for C++ and C, use the C headers.
- :rule:`FILE-011` For C++ standard types, include ``<platform/estdint.h>``. It'll behave as if you
  included ``<cstdint>`` and ``<cstddef>`` and allow the usage of ``size_t`` directly without the
  namespace ``std``.  Please look in the module documentation for more details.