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.