_005f_005fhas_005fbuiltin.html 4.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1987-2023 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. A copy of
  7. the license is included in the
  8. section entitled "GNU Free Documentation License".
  9. This manual contains no Invariant Sections. The Front-Cover Texts are
  10. (a) (see below), and the Back-Cover Texts are (b) (see below).
  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.7, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  20. <title>__has_builtin (The C Preprocessor)</title>
  21. <meta name="description" content="__has_builtin (The C Preprocessor)">
  22. <meta name="keywords" content="__has_builtin (The C Preprocessor)">
  23. <meta name="resource-type" content="document">
  24. <meta name="distribution" content="global">
  25. <meta name="Generator" content="makeinfo">
  26. <link href="index.html" rel="start" title="Top">
  27. <link href="Index-of-Directives.html" rel="index" title="Index of Directives">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Conditional-Syntax.html" rel="up" title="Conditional Syntax">
  30. <link href="_005f_005fhas_005finclude.html" rel="next" title="__has_include">
  31. <link href="_005f_005fhas_005fc_005fattribute.html" rel="prev" title="__has_c_attribute">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.indentedblock {margin-right: 0em}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.lisp {margin-left: 3.2em}
  39. kbd {font-style: oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. span.nolinebreak {white-space: nowrap}
  45. span.roman {font-family: initial; font-weight: normal}
  46. span.sansserif {font-family: sans-serif; font-weight: normal}
  47. ul.no-bullet {list-style: none}
  48. -->
  49. </style>
  50. </head>
  51. <body lang="en">
  52. <span id="g_t_005f_005fhas_005fbuiltin"></span><div class="header">
  53. <p>
  54. Next: <a href="_005f_005fhas_005finclude.html" accesskey="n" rel="next"><code>__has_include</code></a>, Previous: <a href="_005f_005fhas_005fc_005fattribute.html" accesskey="p" rel="prev"><code>__has_c_attribute</code></a>, Up: <a href="Conditional-Syntax.html" accesskey="u" rel="up">Conditional Syntax</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index-of-Directives.html" title="Index" rel="index">Index</a>]</p>
  55. </div>
  56. <hr>
  57. <span id="g_t_005f_005fhas_005fbuiltin-1"></span><h4 class="subsection">4.2.9 <code>__has_builtin</code></h4>
  58. <span id="index-_005f_005fhas_005fbuiltin"></span>
  59. <p>The special operator <code>__has_builtin (<var>operand</var>)</code> may be used in
  60. constant integer contexts and in preprocessor &lsquo;<samp>#if</samp>&rsquo; and &lsquo;<samp>#elif</samp>&rsquo;
  61. expressions to test whether the symbol named by its <var>operand</var> is
  62. recognized as a built-in function by GCC in the current language and
  63. conformance mode. It evaluates to a constant integer with a nonzero
  64. value if the argument refers to such a function, and to zero otherwise.
  65. The operator may also be used in preprocessor &lsquo;<samp>#if</samp>&rsquo; and &lsquo;<samp>#elif</samp>&rsquo;
  66. expressions. The <code>__has_builtin</code> operator by itself, without any
  67. <var>operand</var> or parentheses, acts as a predefined macro so that support
  68. for it can be tested in portable code. Thus, the recommended use of
  69. the operator is as follows:
  70. </p>
  71. <div class="example">
  72. <pre class="example">#if defined __has_builtin
  73. # if __has_builtin (__builtin_object_size)
  74. # define builtin_object_size(ptr) __builtin_object_size (ptr, 2)
  75. # endif
  76. #endif
  77. #ifndef builtin_object_size
  78. # define builtin_object_size(ptr) ((size_t)-1)
  79. #endif
  80. </pre></div>
  81. </body>
  82. </html>