Locale::Po4a::Common − wspólne części narzędzi i użytków po4a
Locale::Po4a::Common zawiera części wspólne wszystkich skryptów po4a i kilka użytecznych funkcji używanych przez inne moduły.
Aby używać Po4a we własnych programach, najprawdopodobniej należy wyłączyć moduł Text::WrapI18N, na przykład pisząc:
use Locale::Po4a::Common qw(nowrapi18n); use Locale::Po4a::Text;
zamiast:
use Locale::Po4a::Text;
Kolejność ma znaczenie: większość modułów Locale::Po4a samodzielnie ładuje Locale::Po4a::Common, który przy swoim pierwszym załadowaniu określa, czy używać Text::WrapI18N.
Pokazywanie komunikatów wyjściowych
• |
show_version($) |
Wyświetla bieżącą wersję skryptu i krótką informację o prawach autorskich. Pobiera nazwę skryptu jako argument.
• |
wrap_msg($@) |
Ta funkcja wyświetla wiadomość w ten sam sposób, co sprnitf(), jednakże zawija ją tak, żeby ładnie wyglądała na terminalu.
• |
wrap_mod($$@) |
Funkcja działa tak jak wrap_msg(), ale jako pierwszy argument pobiera nazwę modułu i pozostawia spację z lewej strony komunikatu.
• |
wrap_ref_mod($$$@) |
Funkcja działa tak jak wrap_msg(), ale jako pierwszy argument pobiera odnośnik plik:linia, jako drugi − nazwę modułu i pozostawia spację z lewej strony komunikatu.
Moduły opakowujące ("wrappers") inne moduły
• |
Locale::Gettext |
Jeżeli moduł Locale::Gettext nie może zostać załadowany, to ten moduł udostępnia fałszywe (puste) implementacje następujących funkcji. Dziki temu program będzie działać, chociaż wiadomości po4a nie będą przetłumaczone.
Jeżeli Locale::gettext jest obecny ten moduł opakowujący wywoła także setlocale( LC_MESSAGES , ""), tak żeby funkcje korzystające z modułu nie musiały zależeć od modułu POSIX .
• |
bindtextdomain($$) |
|||
• |
textdomain($) |
|||
• |
gettext($) |
|||
• |
dgettext($$) |
Jordi Vilalta <jvprat AT gmail DOT com>
Copyright 2005 by SPI , inc.
Program jest wolnym oprogramowaniem; można go redystrybuować i/lub modyfikować zgodnie z warunkami licencji GPL (patrz plik COPYING ).