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>