{count:numf}
or alternative {count :numf}
?
Locale::TextDomain::OO::Plugin::Expand::Gettext::Loc - Additional gettext methods, prefixed with loc_
$Id: Loc.pm 545 2014-10-30 13:23:00Z steffenw $
1.014
This module provides an additional getext methods for static domain and category handling.
my $loc = Locale::Text::TextDomain::OO->new( plugins => [ qw ( Expand::Gettext::Loc ... )], ... );
Optional type formatting or grammar stuff see Locale::Utils::PlaceholderNamed for possible methods.
$loc->expand_gettext_loc->modifier_code($code_ref);
Returns the Locale::Utils::PlaceholderNamed object to be able to set some options.
my $expander_object = $self->expand_gettext_loc;
e.g.
$self->expand_gettext_loc->modifier_code( sub { my ( $value, $attribute ) = @_; if ( $attribute eq 'numf' ) { # modify that numeric $value # e.g. change 1234.56 to 1.234,56 or 1,234.56 ... } elsif ( $attribute eq 'accusative' ) { # modify the string with that grammar rule # e.g. needed for East-European languages # write grammar rules only on msgstr/msgstr_plural[n] # and not on msgid ... } ... return $value; }, );
How to build the method name?
Use loc_ and append this with "n", "p" and/or "x" in alphabetic order.
.------------------------------------------------------------------------. | Snippet | Description | |---------+--------------------------------------------------------------| | loc_ | Special marked for extraction. | | n | Using plural forms. | | p | Context is the first parameter. | | x | Last parameters as hash/hash_ref are for named placeholders. | '------------------------------------------------------------------------'
Translate only
print $loc->loc_( 'Hello World!', );
Expand named placeholders
print $loc->loc_x( 'Hello {name}!', # hash or hash_ref name => 'Steffen', );
Plural
print $loc->loc_n( 'one file read', # Singular 'a lot of files read', # Plural $file_count, # number to select the right plural form );
Plural and expand named placeholders
print $loc->loc_nx( '{count:numf} file read', '{count:numf} files read', $file_count, # hash or hash_ref count => $file_count, );
{count:numf}
or alternative {count :numf}
?That is a attribute.
If there is such an attribute like :numf
and the modifier_code is set,
the placeholder value will be modified before replacement.
Think about the attribute names. Too technical names are able to destroy the translation process by translation office stuff.
For better automatic translation use the reserved attribute :num
and tag all numeric placeholders.
You are allowed to set multiple attributes like {count :num :numf}
The resulting attribute string is then num :numf
.
Context
print $loc->loc_p( 'time', # Context 'to', );
print $loc->loc_p( 'destination', # Context 'to', );
Context and expand named placeholders
print $loc->loc_px( 'destination', 'from {town_from} to {town_to}', # hash or hash_ref town_from => 'Chemnitz', town_to => 'Erlangen', );
Context and plural
print $loc->loc_np( 'maskulin', 'Dear friend', 'Dear friends', $friends, );
Context, plural and expand named placeholders
print $loc->loc_npx( 'maskulin', 'Mr. {name} has {count:num} book.', 'Mr. {name} has {count:num} books.', $book_count, # hash or hash_ref name => $name, count => $book_count, );
How to build the method name?
Use Nloc_ and append this with "n", "p" and/or "x" in alphabetic order.
.------------------------------------------------------------------------. | Snippet | Description | |---------+--------------------------------------------------------------| | loc_ | Special marked for extraction. | | n | Using plural forms. | | p | Context is the first parameter. | | x | Last parameters as hash/hash_ref are for named placeholders. | '------------------------------------------------------------------------'
The extractor looks for loc_('...
and has no problem with $loc->Nloc_('...
.
This is the idea of the N-Methods.
$loc->Nloc_('...'); $loc->Nloc_x('...', ...); ...
Inside of this distribution is a directory named example. Run this *.pl files.
confess
none
Locale::Utils::PlaceholderNamed
not known
none
Steffen Winkler
Copyright (c) 2009 - 2014,
Steffen Winkler
<steffenw at cpan.org>
.
All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.