https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110029
Bug ID: 110029
Summary: more precise documentation for cleanup attribute
Product: gcc
Version: 14.0
Status: UNCONFIRMED
Severity: normal
Priority: P3
Component: c
Assignee: unassigned at gcc dot gnu.org
Reporter: ian at airs dot com
Target Milestone: ---
The cleanup attribute is defined as running a function when a variable goes out
of scope. However, the documentation does not clearly say what happens when
multiple variables are in scope.
For example:
#include <stdio.h>
static void adone (int *p __attribute__((unused))) {
puts("adone");
}
static void bdone (int *p __attribute__((unused))) {
puts("bdone");
}
void f () {
int a __attribute__((cleanup (adone)));
int b __attribute__((cleanup (bdone)));
puts("f");
}
int main() {
f ();
}
With the current implementation, this prints
f
bdone
adone
This follows from the implementation, which is that a cleanup attribute becomes
a try/finally construct at the point of the variable declaration. But it does
not obviously follow from the documentation.
The documentation should be clear about this. Thanks.