NAME

Text::Pipe::Translate - Translate text from one language to another

SYNOPSIS

use Text::Pipe 'pipe';
my $pipe = pipe 'Translate::Babelfish', from => 'en', to => 'de';
my $german = $pipe->filter('My hovercraft is full of eels.'),

DESCRIPTION

This pipe segment can translate text from one language to another. To do so it uses Lingua::Translate.

Both source and destination language are to be given in RFC3066 form. See I18N::LangTags.

METHODS

clear_from
$obj->clear_from;

Clears the value.

clear_to
$obj->clear_to;

Clears the value.

clear_translators
$obj->clear_translators;

Clears the value.

from
my $value = $obj->from;
$obj->from($value);

A basic getter/setter method. If called without an argument, it returns the value. If called with a single argument, it sets the value.

from_clear
$obj->from_clear;

Clears the value.

to
my $value = $obj->to;
$obj->to($value);

A basic getter/setter method. If called without an argument, it returns the value. If called with a single argument, it sets the value.

to_clear
$obj->to_clear;

Clears the value.

translators
my $value = $obj->translators;
$obj->translators($value);

A basic getter/setter method. If called without an argument, it returns the value. If called with a single argument, it sets the value.

translators_clear
$obj->translators_clear;

Clears the value.

get_translator

Constructs a translator object for the current settings of from() and to() and caches it using the translators() accessor.

filter_single

Takes a string and translates it according to the current settings of from() and to().

Text::Pipe::Translate inherits from Text::Pipe::Base.

The superclass Text::Pipe::Base defines these methods and functions:

new(), bit_or(), filter(), init()

The superclass Class::Accessor::Complex defines these methods and functions:

mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(),
mk_class_array_accessors(), mk_class_hash_accessors(),
mk_class_scalar_accessors(), mk_concat_accessors(),
mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(),
mk_new(), mk_object_accessors(), mk_scalar_accessors(),
mk_set_accessors(), mk_singleton()

The superclass Class::Accessor defines these methods and functions:

_carp(), _croak(), _mk_accessors(), accessor_name_for(),
best_practice_accessor_name_for(), best_practice_mutator_name_for(),
follow_best_practice(), get(), make_accessor(), make_ro_accessor(),
make_wo_accessor(), mk_accessors(), mk_ro_accessors(),
mk_wo_accessors(), mutator_name_for(), set()

The superclass Class::Accessor::Installer defines these methods and functions:

install_accessor()

The superclass Class::Accessor::Constructor defines these methods and functions:

_make_constructor(), mk_constructor(), mk_constructor_with_dirty(),
mk_singleton_constructor()

The superclass Data::Inherited defines these methods and functions:

every_hash(), every_list(), flush_every_cache_by_key()

The superclass Class::Accessor::Constructor::Base defines these methods and functions:

STORE(), clear_dirty(), clear_hygienic(), clear_unhygienic(),
contains_hygienic(), contains_unhygienic(), delete_hygienic(),
delete_unhygienic(), dirty(), dirty_clear(), dirty_set(),
elements_hygienic(), elements_unhygienic(), hygienic(),
hygienic_clear(), hygienic_contains(), hygienic_delete(),
hygienic_elements(), hygienic_insert(), hygienic_is_empty(),
hygienic_size(), insert_hygienic(), insert_unhygienic(),
is_empty_hygienic(), is_empty_unhygienic(), set_dirty(),
size_hygienic(), size_unhygienic(), unhygienic(), unhygienic_clear(),
unhygienic_contains(), unhygienic_delete(), unhygienic_elements(),
unhygienic_insert(), unhygienic_is_empty(), unhygienic_size()

The superclass Tie::StdHash defines these methods and functions:

CLEAR(), DELETE(), EXISTS(), FETCH(), FIRSTKEY(), NEXTKEY(), SCALAR(),
TIEHASH()

TAGS

If you talk about this module in blogs, on del.icio.us or anywhere else, please use the textpipetranslate tag.

VERSION

This document describes version 0.03 of Text::Pipe::Translate.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests to <bug-text-pipe-translate@rt.cpan.org>, or through the web interface at http://rt.cpan.org.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.

AUTHOR

Marcel Grünauer, <marcel@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2007-2008 by Marcel Grünauer

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