On Tue, Feb 14, 2023 at 05:07:38PM +0100, Juan Quintela wrote: > Hi > > I want to enter a discussion about changing the default of the style > guide. > > There are several reasons for that: > - they exist since C99 (i.e. all supported compilers support them) > - they eliminate the posibility of an unitialized variable.
Actually they don't do that reliably. In fact, when combined with usage of 'goto', they introduce uninitialized variables, despite the declaration having an initialization present, and thus actively mislead reviewers into thinking their code is safe. Consider this example: #include <stdlib.h> #include <stdio.h> void foo(int something) { if (something == 8) { goto cleanup; } int nitems = 3; int *items = malloc(sizeof(int) *nitems); printf("Hello world %p\n", items); cleanup: printf("nitems=%d items=%p\n", nitems, items); if (nitems) { free(items); } } int main(int argc, char **argv) { foo(atoi(argv[1])); return 0; } Superficially everything looks awesome right - the variables are all initialized at time of declaration after all. $ gcc -Wall -o mixed mixed.c $ ./mixed 3 Hello world 0x18ef2a0 nitems=3 items=0x18ef2a0 $ ./mixed 8 nitems=32677 items=0x7fa5a9209000 free(): invalid pointer Aborted (core dumped) What happens is that when you 'goto $LABEL' across a variable declaration, the variable is in scope at your target label, but its declared initializers never get run :-( Luckily you can protect against that with gcc: $ gcc -Wjump-misses-init -Wall -o mixed mixed.c mixed.c: In function ‘foo’: mixed.c:7:12: warning: jump skips variable initialization [-Wjump-misses-init] 7 | goto cleanup; | ^~~~ mixed.c:15:5: note: label ‘cleanup’ defined here 15 | cleanup: | ^~~~~~~ mixed.c:11:13: note: ‘items’ declared here 11 | int *items = malloc(sizeof(int) *nitems); | ^~~~~ mixed.c:7:12: warning: jump skips variable initialization [-Wjump-misses-init] 7 | goto cleanup; | ^~~~ mixed.c:15:5: note: label ‘cleanup’ defined here 15 | cleanup: | ^~~~~~~ mixed.c:10:12: note: ‘nitems’ declared here 10 | int nitems = 3; | ^~~~~~ however that will warn about *all* cases where we jump over a declared variable, even if the variable we're jumping over is not used at the target label location. IOW, it has significant false positive rates. There are quite a few triggers for this in the QEMU code already if we turn on this warning. It also doesn't alter that the code initialization is misleading to read. > - (at least for me), declaring the index inside the for make clear > that index is not used outside the for. I'll admit that declaring loop indexes in the for() is a nice bit, but I'm not a fan in general of mixing the declarations in the middle of code for projects that use the 'goto cleanup' pattern. > - Current documentation already declares that they are allowed in some > cases. > - Lots of places already use them. > > We can change the text to whatever you want, just wondering if it is > valib to change the standard. > > Doing a trivial grep through my local qemu messages (around 100k) it > shows that some people are complaining that they are not allowed, and > other saying that they are used all over the place. IMHO the status quo is bad because it is actively dangerous when combined with goto and we aren't using any compiler warnings to help us. Either we allow it, but use -Wjump-misses-init to prevent mixing delayed declarations with gotos, and just avoid this when it triggers a false positive. Or we forbid it, rewrite current cases that use it, and then add -Wdeclaration-after-statement to enforce it. IMHO if we are concerned about uninitialized variables then I think a better approach is to add -ftrivial-auto-var-init=zero, which will make the compiler initialize all variables to 0 if they lack an explicit initializer. > Discuss. > --- > docs/devel/style.rst | 23 ++++++++++++++--------- > 1 file changed, 14 insertions(+), 9 deletions(-) > > diff --git a/docs/devel/style.rst b/docs/devel/style.rst > index 68aa776930..dc248aa9e4 100644 > --- a/docs/devel/style.rst > +++ b/docs/devel/style.rst > @@ -202,15 +202,20 @@ Furthermore, it is the QEMU coding style. > Declarations > ============ > > -Mixed declarations (interleaving statements and declarations within > -blocks) are generally not allowed; declarations should be at the beginning > -of blocks. > - > -Every now and then, an exception is made for declarations inside a > -#ifdef or #ifndef block: if the code looks nicer, such declarations can > -be placed at the top of the block even if there are statements above. > -On the other hand, however, it's often best to move that #ifdef/#ifndef > -block to a separate function altogether. > +Declaring variables at first use has two advantages: > +- we can see the right type of the variable just to the use > +- we completely remove the posibility of using a variable that is > + unitialized. > + > +It is especially the case when we are in a for statement. > + > +for (int i = X; i++; ..) { > + ... > +} > + > +Makes clear visually that this variable is not useed outside of the for. > + > +Mixing declarations an code has been allowed since the C99 standard. > > Conditional statements > ====================== > -- > 2.39.1 > > With regards, Daniel -- |: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|