You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

121 lines
5.1KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1988-2020 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  20. <title>Enumerator Attributes (Using the GNU Compiler Collection (GCC))</title>
  21. <meta name="description" content="Enumerator Attributes (Using the GNU Compiler Collection (GCC))">
  22. <meta name="keywords" content="Enumerator Attributes (Using the GNU Compiler Collection (GCC))">
  23. <meta name="resource-type" content="document">
  24. <meta name="distribution" content="global">
  25. <meta name="Generator" content="makeinfo">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="C-Extensions.html#C-Extensions" rel="up" title="C Extensions">
  30. <link href="Statement-Attributes.html#Statement-Attributes" rel="next" title="Statement Attributes">
  31. <link href="Label-Attributes.html#Label-Attributes" rel="prev" title="Label Attributes">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.indentedblock {margin-right: 0em}
  36. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
  37. blockquote.smallquotation {font-size: smaller}
  38. div.display {margin-left: 3.2em}
  39. div.example {margin-left: 3.2em}
  40. div.lisp {margin-left: 3.2em}
  41. div.smalldisplay {margin-left: 3.2em}
  42. div.smallexample {margin-left: 3.2em}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style: oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nolinebreak {white-space: nowrap}
  54. span.roman {font-family: initial; font-weight: normal}
  55. span.sansserif {font-family: sans-serif; font-weight: normal}
  56. ul.no-bullet {list-style: none}
  57. -->
  58. </style>
  59. </head>
  60. <body lang="en">
  61. <a name="Enumerator-Attributes"></a>
  62. <div class="header">
  63. <p>
  64. Next: <a href="Statement-Attributes.html#Statement-Attributes" accesskey="n" rel="next">Statement Attributes</a>, Previous: <a href="Label-Attributes.html#Label-Attributes" accesskey="p" rel="prev">Label Attributes</a>, Up: <a href="C-Extensions.html#C-Extensions" accesskey="u" rel="up">C Extensions</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  65. </div>
  66. <hr>
  67. <a name="Enumerator-Attributes-1"></a>
  68. <h3 class="section">6.37 Enumerator Attributes</h3>
  69. <a name="index-Enumerator-Attributes"></a>
  70. <p>GCC allows attributes to be set on enumerators. See <a href="Attribute-Syntax.html#Attribute-Syntax">Attribute Syntax</a>, for
  71. details of the exact syntax for using attributes. Other attributes are
  72. available for functions (see <a href="Function-Attributes.html#Function-Attributes">Function Attributes</a>), variables
  73. (see <a href="Variable-Attributes.html#Variable-Attributes">Variable Attributes</a>), labels (see <a href="Label-Attributes.html#Label-Attributes">Label Attributes</a>), statements
  74. (see <a href="Statement-Attributes.html#Statement-Attributes">Statement Attributes</a>), and for types (see <a href="Type-Attributes.html#Type-Attributes">Type Attributes</a>).
  75. </p>
  76. <p>This example uses the <code>deprecated</code> enumerator attribute to indicate the
  77. <code>oldval</code> enumerator is deprecated:
  78. </p>
  79. <div class="smallexample">
  80. <pre class="smallexample">enum E {
  81. oldval __attribute__((deprecated)),
  82. newval
  83. };
  84. int
  85. fn (void)
  86. {
  87. return oldval;
  88. }
  89. </pre></div>
  90. <dl compact="compact">
  91. <dt><code>deprecated</code></dt>
  92. <dd><a name="index-deprecated-enumerator-attribute"></a>
  93. <p>The <code>deprecated</code> attribute results in a warning if the enumerator
  94. is used anywhere in the source file. This is useful when identifying
  95. enumerators that are expected to be removed in a future version of a
  96. program. The warning also includes the location of the declaration
  97. of the deprecated enumerator, to enable users to easily find further
  98. information about why the enumerator is deprecated, or what they should
  99. do instead. Note that the warnings only occurs for uses.
  100. </p>
  101. </dd>
  102. </dl>
  103. </body>
  104. </html>