This annotation is used to tag methods and parameters to give extra information
on how they handle
null
. SweetBlue strives to never return
null
if it doesn't have to, preferring things like
BleDeviceState.NULL
for example,
but in some situations it's unavoidable.
NOTE: This annotation is only used in places where the library authors have judged that
the API by itself may be unclear about its
null
handling for newcomers.
In general, if this annotation isn't used, you may assume
Nullable.Prevalence.NEVER
.