]> Cypherpunks.ru repositories - gostls13.git/blobdiff - doc/go1.22.html
doc/go1.22: mention new #cgo directives
[gostls13.git] / doc / go1.22.html
index 1bf759a9a648f845c9eb2391b2838710a199cb8f..c32669b13a488efd4775ce26818acbffb674e714 100644 (file)
@@ -37,6 +37,27 @@ Do not send CLs removing the interior tags from such phrases.
   TODO: complete this section, or delete if not needed
 </p>
 
+<h3 id="cgo">Cgo</h3>
+
+<p><!-- CL 497837 --> The special comment that precedes
+  <code>import</code> <code>"C"</code> may now include two
+  new <code>#cgo</code> directives.
+  <ul>
+    <li>
+      <code>#cgo</code> <code>noescape</code> <code>cFunctionName</code>
+      tells cgo that Go pointers passed to the C function
+      <code>cFunctionName</code> do not escape.
+    </li>
+    <li>
+      <code>#cgo</code> <code>nocallback</code> <code>cFunctionName</code>
+      tells cgo that the C function <code>cFunctionName</code> does
+      not call any Go functions.
+    </li>
+  </ul>
+  See <a href="/cmd/cgo#hdr-Optimizing_calls_of_C_code">the <code>cgo</code>
+  documentation</a> for more details.
+</p>
+
 <h2 id="runtime">Runtime</h2>
 
 <p>