Skip to main content

style-warning

style-warning Condition Type

Class Precedence List:

style-warning, warning, condition, t

Description:

The type style-warning includes those conditions that represent situations involving code that is conforming code but that is nevertheless considered to be faulty or substandard.

See Also:

muffle-warning

Notes:

An implementation might signal such a condition if it encounters code that uses deprecated features or that appears unaesthetic or inefficient.

An ‘unused variable’ warning must be of type style-warning.

In general, the question of whether code is faulty or substandard is a subjective decision to be made by the facility processing that code. The intent is that whenever such a facility wishes to complain about code on such subjective grounds, it should use this condition type so that any

clients who wish to redirect or muffle superfluous warnings can do so without risking that they will be redirecting or muffling other, more serious warnings.

Expanded Reference: style-warning​

The style-warning Type​

style-warning is a subtype of warning used for conditions related to code style issues, such as unused variables or redefined functions. Implementations typically signal style-warning conditions during compilation.

(subtypep 'style-warning 'warning)

=> T
=> T

Signaling a Style Warning​

(handler-bind ((style-warning (lambda (c)
                                (declare (ignore c))
                                (muffle-warning))))
  (warn 'style-warning
        :format-control "Variable ~S is unused"
        :format-arguments '(x))
  :done)

=> :DONE

Distinguishing Style Warnings from Other Warnings​

(handler-case
    (warn 'simple-warning :format-control "regular warning")
  (style-warning () :style)
  (warning () :other-warning))

=> :OTHER-WARNING