acquire

Records one occurrence of key and decides whether it should be reported.

Returns null when the event must be suppressed, otherwise the number of occurrences suppressed since this signature was last reported — 0 in the ordinary case.