store

Write a key-value pair to the database. Invoked by Perl’s tie machinery when the user writes $h{key} = $value.

The combined length of key and value must not exceed 1008 bytes (the PAIRMAX constant). Oversized pairs are rejected: STORE croaks with sdbm store returned -1, errno 22, key "..." and nothing is written.

An attempt to write to a read-only database croaks with No write permission to sdbm file.

Undef values are stored as empty strings, matching perl5’s silent-coerce behavior for tied hashes.