NAME

       Biblio::SICI::Util - Utility functions

VERSION

       version 0.04

SYNOPSIS

         use Biblio::Sici;
         use Biblio::SICI::Util qw( titleCode_from_title calculate_check_char );

         my $sici = Biblio::Sici->new();

         ...

         if ( my $code = titleCode_from_title($title) ) {
             $sici->contribution->titleCode($code);
         }

DESCRIPTION

       This module provides some utility functions which are useful when working with SICI.

       None of them are exported by default.

FUNCTIONS

       STRING "titleCode_from_title"( STRING )
           Tries to derive the "titleCode" (cf. the contribution segment) from a string (i.e.:
           the title of the contribution) passed to it.

           Since the rules for the construction of the "titleCode" are quite complex, this method
           probably won´t generate the correct code if the title contains elements other than
           regular english words (like mathematical or chemical symbols or characters from a non-
           ascii alphabet).

           If the method is able to generate a code it will be returned.  Otherwise the return
           value is "undef".

           In order to have a better chance of generating a standard-conformant code the modules
           Text::Unidecode and Text::Undiacritic are "require"d.  If they cannot be found,
           warnings are emitted but a code might nonetheless be generated. However, if the title
           is in a language other than english, the probability of generating the correct code
           sinks even more.

       STRING "calculate_check_char"( STRING )
           Calculates and returns the check character.  Does not check, if the string param is a
           valid SICI!

           A check character already present in the passed-in SICI will simply be ignored.

AUTHOR

       Heiko Jansen <hjansen@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2014 by Heiko Jansen.

       This is free software; you can redistribute it and/or modify it under the same terms as
       the Perl 5 programming language system itself.