bool mal interpretado como parâmetro de função

Temos muitos estilos de codificação ou especificações de codificação. Mas muitas vezes esse item pode ser esquecido por nós, ou seja, costumamos usar parâmetros bool nos parâmetros de função, o que reduzirá bastante a legibilidade do código. Não acredite? Vejamos primeiro o código abaixo.
Ao ler o código a seguir, o que você acha que esse código significa?
widget->repaint(false); Deseja repintar? Ou significa outra coisa?
Após a leitura do documento, aprendemos que este parâmetro é imediato, ou seja, falso significa não redesenhar imediatamente, e verdadeiro significa que o código será redesenhado imediatamente.
Também existe essa função na API do Windows: InvalidateRect Quando você vê o código a seguir, o que você acha que significa?
InvalidateRect(hwnd, lpRect, false); Não vamos falar sobre o quão ruim é o nome da função InvalidateRect. Vamos falar primeiro sobre o parâmetro false? invalidar significa "invalidar XXX", o que significa falso? Duplo negativo? Isso significa afirmativamente?
Se você vir um código como este, será bastante confuso. Então, você tem que olhar a documentação ou a definição da função InvalidateRect. Você verá que o parâmetro é BOOL bErase, que significa: "Se você deseja redesenhar o plano de fundo."
Existem muitas coisas assim. Olhando para o código a seguir, quero substituir "%USER%" em str pelo nome de usuário real:
str.replace("%USER%", usuário, false); // Qt 3TNND, o que significa falso? Não está substituindo? Ou significa outra coisa?
Depois de ler a documentação, descobri que false significa: "substituição sem distinção entre maiúsculas e minúsculas".
Na verdade, se você usar variáveis/constantes enum em vez de variáveis ​​bool, você tornará seu código mais legível, como:

Que diabos é isso?
Depois de ler a documentação, você saberá que isso é setCentered(centered, autoUpdate);
nova caixa de texto(300, 100, falso, verdadeiro);O que é isso?
Depois de ler o documento, percebi que se trata de criar uma caixa de texto. O terceiro parâmetro é: "Se você deseja barras de rolagem", e o quarto parâmetro é: "Se você deseja quebra automática de linha". TND!
Esta situação não é das piores, vejam a dupla negativa abaixo.

Depois de ler este artigo, espero que você nunca mais use bool como parâmetro de função. A menos que haja dois motivos:
Você tem 100% de certeza que isso não causará problemas de leitura, como o setVisible (bool) do Java.
Você tem 100% de certeza de que deseja escrever um código misterioso.
Se você deseja projetar uma boa API, é altamente recomendável que você leia os "Princípios de Design de API" do Qt da Nokia. Este artigo é a "armadilha booleana" nele.