diff options
| author | Jonathan Yong <10walls@gmail.com> | 2021-08-25 16:36:14 +0000 |
|---|---|---|
| committer | Jonathan Yong <10walls@gmail.com> | 2021-08-26 01:32:34 +0000 |
| commit | d4b782985b4adb86ebcccff697366136321d45b2 (patch) | |
| tree | a317127991da87b400798f20a11a0d4af3814467 /gcc/doc | |
| parent | 0012f921b6756d37e507f88c38aabc911d2e6831 (diff) | |
| download | gcc-d4b782985b4adb86ebcccff697366136321d45b2.zip gcc-d4b782985b4adb86ebcccff697366136321d45b2.tar.gz gcc-d4b782985b4adb86ebcccff697366136321d45b2.tar.bz2 | |
extend.texi: add note about reserved ctor/dtor priorities
gcc/Changelog:
* doc/extend.texi: Add note about reserved priorities
to the constructor attribute.
Signed-off-by: Jonathan Yong <10walls@gmail.com>
Diffstat (limited to 'gcc/doc')
| -rw-r--r-- | gcc/doc/extend.texi | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index 49df8e6..251a103 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -2787,16 +2787,16 @@ On some targets the attributes also accept an integer argument to specify a priority to control the order in which constructor and destructor functions are run. A constructor with a smaller priority number runs before a constructor with a larger -priority number; the opposite relationship holds for destructors. So, -if you have a constructor that allocates a resource and a destructor -that deallocates the same resource, both functions typically have the -same priority. The priorities for constructor and destructor -functions are the same as those specified for namespace-scope C++ -objects (@pxref{C++ Attributes}). However, at present, the order in which -constructors for C++ objects with static storage duration and functions -decorated with attribute @code{constructor} are invoked is unspecified. -In mixed declarations, attribute @code{init_priority} can be used to -impose a specific ordering. +priority number; the opposite relationship holds for destructors. Note +that priorities 0-100 are reserved. So, if you have a constructor that +allocates a resource and a destructor that deallocates the same +resource, both functions typically have the same priority. The +priorities for constructor and destructor functions are the same as +those specified for namespace-scope C++ objects (@pxref{C++ Attributes}). +However, at present, the order in which constructors for C++ objects +with static storage duration and functions decorated with attribute +@code{constructor} are invoked is unspecified. In mixed declarations, +attribute @code{init_priority} can be used to impose a specific ordering. Using the argument forms of the @code{constructor} and @code{destructor} attributes on targets where the feature is not supported is rejected with |