add five new api functions with tests

subj
few small fixes:  "if !" => "unless"

whether to file readme.pod add descriptions of new methods? 
Or rather what is in pod-documentation  in the pm-file?