NAME

Encoding::FixLatin::XS - XS implementation layer for Encoding::FixLatin

SYNOPSIS

use Encoding::FixLatin  qw(fix_latin);    # will load XS module if available

my $utf8_string = fix_latin($mixed_encoding_string);

DESCRIPTION

This module provides a C implementation of the 'fix_latin' algorithm. It is not meant to be called directly. Instead, simply install this module and use Encoding::FixLatin as normal. Encoding::FixLatin will use this module if it's found and will fall back to the pure-Perl implementation otherwise.

The fix_latin function accepts a use_xs option which can be used to control how this module is used:

# Default behaviour: try to load/use XS module, fall back to PP on failure

$out = fix_latin($in, use_xs => 'auto');

# Always try to load/use XS module, die if it's not available

$out = fix_latin($in, use_xs => 'always');

# Never try to load/use XS module, always use pure-Perl implementation

$out = fix_latin($in, use_xs => 'never');

SEE ALSO

Encoding::FixLatin

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Encoding::FixLatin::XS

You can also look for information at:

• Issue tracker

  https://github.com/grantm/encoding-fixlatin-xs/issues

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Encoding::FixLatin::XS

• CPAN Ratings

  http://cpanratings.perl.org/d/Encoding::FixLatin::XS

• Search CPAN

  http://search.cpan.org/dist/Encoding::FixLatin::XS/

• Source Code Respository

  http://github.com/grantm/encoding-fixlatin-xs

COPYRIGHT AND LICENSE

Copyright (C) 2014 by Grant McLean <grantm@cpan.org>

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