mirror of
https://github.com/llvm/llvm-project.git
synced 2025-04-16 17:37:03 +00:00
59716479fc
We have a buch of coding guidelines which are either documented as design docs, which aren't really applicable or not at all. This moves coding guidelines we have currently in the design docs into a separate file and adds a bunch of guidelines which we have but aren't documented anywhere.
50 lines
1.4 KiB
ReStructuredText
50 lines
1.4 KiB
ReStructuredText
=======================
|
|
Extended C++03 Support
|
|
=======================
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
Overview
|
|
========
|
|
|
|
libc++ is an implementation of the C++ standard library targeting C++11 or later.
|
|
|
|
In C++03, the library implements the C++11 standard using C++11 language extensions provided
|
|
by Clang.
|
|
|
|
This document tracks the C++11 extensions libc++ requires, the C++11 extensions it provides,
|
|
and how to write minimal C++11 inside libc++.
|
|
|
|
Required C++11 Compiler Extensions
|
|
==================================
|
|
|
|
Clang provides a large subset of C++11 in C++03 as an extension. The features
|
|
libc++ expects Clang to provide are:
|
|
|
|
* Variadic templates.
|
|
* RValue references and perfect forwarding.
|
|
* Alias templates
|
|
* defaulted and deleted Functions.
|
|
* reference qualified Functions
|
|
* ``auto``
|
|
|
|
There are also features that Clang *does not* provide as an extension in C++03
|
|
mode. These include:
|
|
|
|
* ``constexpr`` and ``noexcept``
|
|
* Trailing return types.
|
|
* ``>>`` without a space.
|
|
|
|
|
|
Provided C++11 Library Extensions
|
|
=================================
|
|
|
|
.. warning::
|
|
The C++11 extensions libc++ provides in C++03 are currently undergoing change. Existing extensions
|
|
may be removed in the future. New users are strongly discouraged depending on these extension
|
|
in new code.
|
|
|
|
This section will be updated once the libc++ developer community has further discussed the
|
|
future of C++03 with libc++.
|