NAME

       Biblio::Citation::Parser::Utils - OpenURL utility functions

DESCRIPTION

       This module contains methods for the parsing of reference metadata into OpenURLs. Although we have aimed
       to make it 1.0 compliant, there may well be errors (please let us know if there are!).

METHODS

       $openurl_hash = Biblio::Citation::Parser::Utils::trim_openurl($openurl)
           This method takes a hash of metadata, and returns a hash that contains only valid OpenURL fields.

       $openurl_hash = Biblio::Citation::Parser::Utils::decompose_openurl($openurl)
           This  method  aims  to  enrich an OpenURL metadata hash by applying various parsing techniques to the
           fields.  It decomposes dates into years, months, and days  if  possible,  fills  in  the  appropriate
           fields  if SICIs are present, and ensures URLs, ISBNs, etc, are valid. It returns a pointer to a hash
           containing the modified metadata, and an array of errors (if any).

       $openurl = Biblio::Citation::Parser::create_openurl($metadata)
           This method creates and returns an OpenURL from a metadata hash.  No base URLs are prepended to this,
           so this should be done before using it as a link. URI::OpenURL should be used to generate OpenURLs in
           place of this function.

       $valid_isbn = Biblio::Citation::Parser::Utils::isbn_check(@isbn_chars)
           This is a simple function that takes an array of ISBN characters, and returns true if it is  a  valid
           ISBN.

       $sici_hash = Biblio::Citation::Parser::Utils::parse_sici($sici)
           This  function  takes a SICI string, and returns a hash of information parsed from it, including date
           information, issn numbers, etc.

       $bici_hash = Biblio::Citation::Parser::Utils::parse_bici($bici)
           This is not yet implemented, but will eventually be the BICI alternative for parse_sici.

       $escaped_url = ParaTools::Utils::url_escape($string)
           Simple function to convert a string into an  encoded  URL  (i.e.  spaces  to  %20,  etc).  Takes  the
           unencoded URL as a parameter, and returns the encoded version.

AUTHOR

       Mike Jewell <moj@ecs.soton.ac.uk>

perl v5.36.0                                       2022-11-19               Biblio::Citation::Parser::Utils(3pm)