int key_exists

(bbskey_t* keys, int key)

Check for a key in a key array.

Documentation

Check for a key in a key array.

Examines the given key array for ownership of the specified key. Two keys are handled specially: key 0 is the `non-key'. All users implicitly have this one. Key 129 is the Sysop key. Only user `Sysop' (or whatever the value of the macro SYSOP is) has this key. Not even users with the master key (usually 128, but can be changed at will) can unlock features locked with the Sysop key. All other keys are explicitly specified in the key array.

If you need to check a user for ownership of a key, this isn't the right function. You need key_owns().

Parameters:

- keys A key array to test for key ownership. @parm key Key number to check.

Returns:

Zero if the key array does not contain the key; non-zero if it does.

See Also:

key_owns().

Alphabetic index