motiejus/zig
1
Fork 0
Code Releases Activity

revert langref section "common errdefer slip ups"

Browse Source 
This does not belong in the language reference.

reverts 91a88a789f
This commit is contained in:
Andrew Kelley
2024-11-26 15:03:24 -08:00
parent 11bf2d92de
commit 3ce6de8765
5 changed files with 0 additions and 178 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
doc/langref.html.in
View File

@@ -3052,32 +3052,6 @@ fn createFoo(param: i32) !Foo {
The {#syntax#}errdefer{#endsyntax#} statement can optionally capture the error:
</p>
{#code|test_errdefer_capture.zig#}
{#header_close#}
{#header_open|Common errdefer Slip-Ups#}
<p>
It should be noted that {#syntax#}errdefer{#endsyntax#} statements only last until the end of the block
they are written in, and therefore are not run if an error is returned outside of that block:
</p>
{#code|test_errdefer_slip_ups.zig#}
<p>
To ensure that {#syntax#}deallocateFoo{#endsyntax#} is properly called
when returning an error, you must add an {#syntax#}errdefer{#endsyntax#} outside of the block:
</p>
{#code|test_errdefer_block.zig#}
<p>
The fact that errdefers only last for the block they are declared in is
especially important when using loops:
</p>
{#code|test_errdefer_loop_leak.zig#}
<p>
Special care must be taken with code that allocates in a loop
to make sure that no memory is leaked when returning an error:
</p>
{#code|test_errdefer_loop.zig#}
{#header_close#}
<p>
A couple of other tidbits about error handling: