| ... | ... | @@ -6215,6 +6215,35 @@ test "main" { |
| 6215 | 6215 | <p> |
| 6216 | 6216 | Creates a symbol in the output object file. |
| 6217 | 6217 | </p> |
| 6218 | <p> |
| 6219 | This function can be called from a {#link|comptime#} block to conditionally export symbols. |
| 6220 | When {#syntax#}target{#endsyntax#} is a function with the C calling convention and |
| 6221 | {#syntax#}linkage{#endsyntax#} is {#syntax#}Strong{#endsyntax#}, this is equivalent to |
| 6222 | the {#syntax#}export{#endsyntax#} keyword used on a function: |
| 6223 | </p> |
| 6224 | {#code_begin|obj#} |
| 6225 | const builtin = @import("builtin"); |
| 6226 | |
| 6227 | comptime { |
| 6228 | @export("foo", internalName, builtin.GlobalLinkage.Strong); |
| 6229 | } |
| 6230 | |
| 6231 | extern fn internalName() void {} |
| 6232 | {#code_end#} |
| 6233 | <p>This is equivalent to:</p> |
| 6234 | {#code_begin|obj#} |
| 6235 | export fn foo() void {} |
| 6236 | {#code_end#} |
| 6237 | <p>Note that even when using {#syntax#}export{#endsyntax#}, {#syntax#}@"foo"{#endsyntax#} syntax can |
| 6238 | be used to choose any string for the symbol name:</p> |
| 6239 | {#code_begin|obj#} |
| 6240 | export fn @"A function name that is a complete sentence."() void {} |
| 6241 | {#code_end#} |
| 6242 | <p> |
| 6243 | When looking at the resulting object, you can see the symbol is used verbatim: |
| 6244 | </p> |
| 6245 | <pre>00000000000001f0 T A function name that is a complete sentence.</pre> |
| 6246 | {#see_also|Exporting a C Library#} |
| 6218 | 6247 | {#header_close#} |
| 6219 | 6248 | |
| 6220 | 6249 | {#header_open|@fence#} |
| ... | ... | @@ -8074,6 +8103,7 @@ pub fn build(b: *Builder) void { |
| 8074 | 8103 | $ ./test |
| 8075 | 8104 | $ echo $? |
| 8076 | 8105 | 0</code></pre> |
| 8106 | {#see_also|export#} |
| 8077 | 8107 | {#header_close#} |
| 8078 | 8108 | {#header_open|Mixing Object Files#} |
| 8079 | 8109 | <p> |
Andrew Kelley <andrew@ziglang.org> 2019-03-13 11:54:56-04:00
Commit is signed but in an unrecognized format.