added a useful function to the API


git-svn-id: https://ilk.uvt.nl/svn/sources/ucto/trunk@17654 12f355fe-0486-481a-ad91-c297ab22b4e3