[clang-tidy] Improve bugprone-unused-return-value check (#66573)

Improve diagnostic message to be more straight forward, fix handling of 
casting to non-void and add new option AllowCastToVoid to control
casting
to void behavior.

Closes #66570