W8057
C++ Builder Programming Language
Severity: MinorWhat Does This Error Mean?
W8057 is a warning that a function receives a named parameter that its body never references. This can indicate a missing step (you forgot to use the parameter) or be intentional for interface compatibility (the signature must match a callback or virtual method but the parameter is not needed in this particular implementation). The fix depends on intent: use the parameter, remove it, or suppress the warning with a cast to void.
Affected Models
- C++ Builder 10.x (Alexandria)
- C++ Builder 11 (Sydney)
- C++ Builder 12 (Athens)
- RAD Studio 11 and 12
Common Causes
- A parameter was added to a function signature but the implementation was not updated to use it
- Code was refactored and the parameter is no longer needed but the signature was not simplified
- A virtual method or callback override that does not need all parameters its interface requires
- A parameter reserved for future use or kept for ABI compatibility
How to Fix It
-
Check whether the parameter was supposed to be used. If the function logic is incomplete, add the missing code that uses the parameter.
A missing parameter use often reveals a logic gap — something the function was supposed to do with that input but does not.
-
If the parameter is intentionally unused (e.g., a callback that must match a fixed signature), suppress the warning by casting the parameter to void on its own line.
The cast-to-void pattern is the standard C++ idiom for silencing unused-parameter warnings without changing behavior. It documents that the parameter is deliberately unused.
-
If the parameter is no longer needed at all, remove it from both the declaration (header) and the definition (source). Update all call sites.
Removing unused parameters makes the interface cleaner. If the function is part of a public API or callback interface, removing a parameter is a breaking change — keep it but suppress the warning instead.
Frequently Asked Questions
Can I just remove the parameter name to suppress W8057?
Yes — in C++ you can declare a parameter without a name. The type appears in the signature but no name is given. This compiles without W8057 and signals to readers that the parameter is intentionally unused. This is an alternative to the cast-to-void approach.