Log::Report::Translator(3)                 User Contributed Perl Documentation


NAME
       Log::Report::Translator - base implementation for translating messages

INHERITANCE
        Log::Report::Translator is extended by
          Log::Report::Translator::Gettext
          Log::Report::Translator::POT

SYNOPSIS
         # internal infrastructure
         my $msg = Log::Report::Message->new(_msgid => "Hello World\n");
         print Log::Report::Translator->new(...)->translate($msg);

         # normal use
         textdomain 'my-domain',
           translator => Log::Report::Translator->new;  # default
         print __"Hello World\n";

DESCRIPTION
       A module (or distribution) has a certain way of translating messages,
       usually "gettext".  The translator is based on some "textdomain" for
       the message, which can be specified as option per text element, but
       usually is package scoped.

       This base class does not translate at all: it will use the MSGID (and
       MSGID_PLURAL if available).  It's a nice fallback if the language packs
       are not installed.

METHODS
   Constructors
       $class->new(%options)


   Accessors
   Translating
       $obj->load($domain, $locale)
           Load the translation information in the text $domain for the
           indicated $locale.  Multiple calls to load() should not cost
           significant performance: the data must be cached.

       $obj->translate( $message, [$language, $ctxt] )
           Returns the translation of the $message, a Log::Report::Message
           object, based on the current locale.

           Translators are permitted to peek into the internal HASH of the
           message object, for performance reasons.

SEE ALSO
       This module is part of Log-Report version 1.43, built on December 05,
       2025. Website: http://perl.overmeer.net/CPAN/

LICENSE
       For contributors see file ChangeLog.

       This software is copyright (c) 2007-2025 by Mark Overmeer.

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

perl v5.42.0                      2025-12-12        Log::Report::Translator(3)