Modern-GNU-Objective_002dC-runtime-API.html 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  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-2017 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 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>Using the GNU Compiler Collection (GCC): Modern GNU Objective-C runtime API</title>
  20. <meta name="description" content="Using the GNU Compiler Collection (GCC): Modern GNU Objective-C runtime API">
  21. <meta name="keywords" content="Using the GNU Compiler Collection (GCC): Modern GNU Objective-C runtime API">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  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="GNU-Objective_002dC-runtime-API.html#GNU-Objective_002dC-runtime-API" rel="up" title="GNU Objective-C runtime API">
  30. <link href="Traditional-GNU-Objective_002dC-runtime-API.html#Traditional-GNU-Objective_002dC-runtime-API" rel="next" title="Traditional GNU Objective-C runtime API">
  31. <link href="GNU-Objective_002dC-runtime-API.html#GNU-Objective_002dC-runtime-API" rel="prev" title="GNU Objective-C runtime API">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  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.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="Modern-GNU-Objective_002dC-runtime-API"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="Traditional-GNU-Objective_002dC-runtime-API.html#Traditional-GNU-Objective_002dC-runtime-API" accesskey="n" rel="next">Traditional GNU Objective-C runtime API</a>, Up: <a href="GNU-Objective_002dC-runtime-API.html#GNU-Objective_002dC-runtime-API" accesskey="u" rel="up">GNU Objective-C runtime API</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>
  66. </div>
  67. <hr>
  68. <a name="Modern-GNU-Objective_002dC-Runtime-API"></a>
  69. <h4 class="subsection">8.1.1 Modern GNU Objective-C Runtime API</h4>
  70. <p>The GNU Objective-C runtime provides an API which is similar to the
  71. one provided by the &ldquo;Objective-C 2.0&rdquo; Apple/NeXT Objective-C
  72. runtime. The API is documented in the public header files of the GNU
  73. Objective-C runtime:
  74. </p>
  75. <ul>
  76. <li> <samp>objc/objc.h</samp>: this is the basic Objective-C header file,
  77. defining the basic Objective-C types such as <code>id</code>, <code>Class</code>
  78. and <code>BOOL</code>. You have to include this header to do almost
  79. anything with Objective-C.
  80. </li><li> <samp>objc/runtime.h</samp>: this header declares most of the public runtime
  81. API functions allowing you to inspect and manipulate the Objective-C
  82. runtime data structures. These functions are fairly standardized
  83. across Objective-C runtimes and are almost identical to the Apple/NeXT
  84. Objective-C runtime ones. It does not declare functions in some
  85. specialized areas (constructing and forwarding message invocations,
  86. threading) which are in the other headers below. You have to include
  87. <samp>objc/objc.h</samp> and <samp>objc/runtime.h</samp> to use any of the
  88. functions, such as <code>class_getName()</code>, declared in
  89. <samp>objc/runtime.h</samp>.
  90. </li><li> <samp>objc/message.h</samp>: this header declares public functions used to
  91. construct, deconstruct and forward message invocations. Because
  92. messaging is done in quite a different way on different runtimes,
  93. functions in this header are specific to the GNU Objective-C runtime
  94. implementation.
  95. </li><li> <samp>objc/objc-exception.h</samp>: this header declares some public
  96. functions related to Objective-C exceptions. For example functions in
  97. this header allow you to throw an Objective-C exception from plain
  98. C/C++ code.
  99. </li><li> <samp>objc/objc-sync.h</samp>: this header declares some public functions
  100. related to the Objective-C <code>@synchronized()</code> syntax, allowing
  101. you to emulate an Objective-C <code>@synchronized()</code> block in plain
  102. C/C++ code.
  103. </li><li> <samp>objc/thr.h</samp>: this header declares a public runtime API threading
  104. layer that is only provided by the GNU Objective-C runtime. It
  105. declares functions such as <code>objc_mutex_lock()</code>, which provide a
  106. platform-independent set of threading functions.
  107. </li></ul>
  108. <p>The header files contain detailed documentation for each function in
  109. the GNU Objective-C runtime API.
  110. </p>
  111. <hr>
  112. <div class="header">
  113. <p>
  114. Next: <a href="Traditional-GNU-Objective_002dC-runtime-API.html#Traditional-GNU-Objective_002dC-runtime-API" accesskey="n" rel="next">Traditional GNU Objective-C runtime API</a>, Up: <a href="GNU-Objective_002dC-runtime-API.html#GNU-Objective_002dC-runtime-API" accesskey="u" rel="up">GNU Objective-C runtime API</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>
  115. </div>
  116. </body>
  117. </html>