Provided by: manpages-zh_1.5.1-1_all bug

NAME

       msgcat - Tcl 消息目录

 SYNOPSIS
       package require Tcl 8.2

       package require msgcat 1.1

       ::msgcat::mc src-string

       ::msgcat::mclocale ?newLocale?

       ::msgcat::mcpreferences

       ::msgcat::mcload dirname

       ::msgcat::mcset locale src-string ?translate-string?

       ::msgcat::mcunknown locale src-string
_________________________________________________________________

 DESCRIPTION
       msgcat
       包提供用来管理多语言的用户界面的一系列函数。在独立于应用的一个“消息目录”中定义文本串,可以编-
       和修改这些文本串而不用修改应用的源代码。通过向这个消息目录增加一个新文件来提供一个新语言或地域(locale)。

       对任何应用和包使用消息目录都是可选的,但是鼓励你使用它,以便应用或包在多语言环境中被采用。

 COMMANDS
       ::msgcat::mc src-string ?arg arg ...?
              依照用户的当前地区,返回 src-string   的芬(translation)。如果在
              src-string 之后给出了附加的参数,使用 format  命令把  src-string
              的芬胫械淖恢付ǚ婊怀刹钩洳问

              为了芬                  src-string                 ::msgcat::mc
              将在当前名字空间中查找定义的消息;如果未找到,它将在当前的名字空间的父空间中查找,以此类推直到到达全局名字空间。如果不存在转换字符串,调用
              ::msgcat::mcunknown 并返回 ::msgcat::mcunknown  的返回。

       ::msgcat::mc
       是用来本地化一个应用的主要函数。不再直接的使用英文字符串,一个应用可以把英文字符串传递给
       ::msgcat::mc
       并使用它的结果。如果以这种方式用一种语言写了一个应用,通过简单的定义新的消息目录条目,以后增加附加的语言支持是很容易的。

       ::msgcat::mclocale ?newLocale?
              这个函数把地域设置成                       newLocale。如果省略了
              newLocale,返回当前的地域,否则当前的地域被设置成
              newLocale。初始的地域缺省为在用户的环境变量中指定的地域。关于地域字符串的格式的详细描述参见下面的
              LOCALE AND SUBLOCALE SPECIFICATION 地域和子地域指定章节。

       ::msgcat::mcpreferences
              返回一个有序的地域列表,它们是基于用户指定的语言,以用户喜好程度为次序。次序是从最偏好到最不喜好的。如果用户已-
              指定了LANG=en_US_funky,这个过程将返回{en_US_funky en_US en}。

       ::msgcat::mcload dirname
              在指定的目录中查找一个文件,这个文件匹配用
              ::msgcat::mcpreferences
              返回的语言指定。每个文件的根文件名是地域字符串,扩展名是“.msg”。返回匹配的指定和装载了消息的数目。

       ::msgcat::mcset locale src-string ?translate-string?
              在指定的 locale 中设置从 src-stringtranslate-string   的-
              译。如果未指定     translate-string,对二者都使用     src-string
              。函数返回 translate-string::msgcat::mcunknown locale src-string
              在当前的地域中没有给  src-string   定义的芬氲那榭鱿拢飧隼瘫
              ::msgcat::mc             调用。缺省的动作是返回             src-
              string。这个过程可以被这个应用重新定义,比如对每个未知字符串记录错误消息日志。在与
              ::msgcat::mc   相同的栈层次上调用   ::msgcat::mcunknown   过程。
              ::msgcat::mcunknown  的返回值被用做 ::msgcat::mc 的返回值。

 LOCALE AND SUBLOCALE SPECIFICATION
       用地域字符串指定地域。地域字符串的组成是一个语言代码,一个可选的国家(地区)代码,一个可选的特定于系统代码,它们用“_”分割。国家和语言代码在标准ISO-639
       和  ISO-3166  中。例如,地域“en”指定  English  而“en_US”指定   U.S.
       English。

       区域定义缺省为装载   msgcat   包时在    env(LANG)    中的值。如果未定义
       env(LANG),则地域缺省为“C”。

       在用户指定一个地域的时候,在字符串-
       译期间进行“最佳匹配”查找。例如,如果用户指定了
       en_UK_Funky,按“en_UK_Funky”、“en_UK”、和“en”
       的次序查找地域,直到找到一个匹配的字符串芬搿H绻挥姓业秸飧鲎址姆-
       译,则调用 ::msgcat::unknown。

       译注:常用地域字符串的一部分
              语言 国家(地区)地域 ID
              Arabic Saudi Arabiaar_SA
              Chinese (Simplified)Chinazh_CN
              Chinese (Traditional)Taiwanzh_TW
              English   United Statesen_US
              French Francefr_FR
              German Germanyde_DE
              Hebrew Israeliw_IL
              Italian   Italyit_IT
              Japanese  Japanja_JP
              Korean South Koreako_KR
              Spanish   Spaines_ES
              Swedish   Swedensv_SE

NAME

       在消息目录中存储的字符串被存储为相对于在其中增加它们的那个名字空间。这允许多个包使用相同的字符串而不用害怕与其他包冲突。它还允许源字符串被缩写而减少(less
       prone to)排字错误。

       例如,执行代码
              mcset en hello "hello from ::"
              namespace eval foo {mcset en hello "hello from ::foo"}
              puts [mc hello]
              namespace eval foo {puts [mc hello]}
       将输出
              hello from ::
              hello from ::foo

       在查找一个消息的-
       译的时候,消息目录将首先查找当前名字空间,接着是当前名字空间的父名字空间,以次类推知道到达全局名字空间。这允许子名字空间从它的父名字空间“继承”消息。

       例如,执行代码
              mcset en m1 ":: message1"
              mcset en m2 ":: message2"
              mcset en m3 ":: message3"
              namespace eval ::foo {
                  mcset en m2 "::foo message2"
                  mcset en m3 "::foo message3"
              }
              namespace eval ::foo::bar {
                  mcset en m3 "::foo::bar message3"
              }
              puts "[mc m1]; [mc m2]; [mc m3]"
              namespace eval ::foo {puts "[mc m1]; [mc m2]; [mc m3]"}
              namespace eval ::foo::bar {puts "[mc m1]; [mc m2]; [mc m3]"}
       将输出
              :: message1; :: message2; :: message3
              :: message1; ::foo message2; ::foo message3
              :: message1; ::foo message2; ::foo::bar message3

 LOCATION AND FORMAT OF MESSAGE FILES
       消息文件可以位于任何目录中,取决于下列条件:

       [1]    给一个包的所有消息文件都在相同的目录中。

       [2]    消息文件名跟一个地域指定符并跟随着“.msg”。例如:
              es.msg    -- spanish
              en_UK.msg -- UK English

       [3]    这个文件包含一系列对  mcset   的调用,它们为这个语言设置需要的-
              译字符串。例如:
              ::msgcat::mcset es "Free Beer!" "Cerveza Gracias!"

 RECOMMENDED MESSAGE SETUP FOR PACKAGES
       如果一个包被安装到tcl_pkgPath    的一个子目录中并通过  package  require
       装载,推荐下列过程。

       [1]    在包安装期间,在你的包目录下建立一个子目录msgs。

       [2]    复制你的 *.msg 文件到这个目录中。

       [3]    在你的包初始化脚本中增加下列命令:
              # load language files, stored in msgs subdirectory
              ::msgcat::mcload [file join [file dirname [info script]] msgs]

 FORMAT  SCAN   POSTITIONAL  CODES  FOR  FORMAT  AND  SCAN
       COMMANDS
       用做给   format  的参数的一个消息字符串中的转换指定符可以包含一个  XPG3
       位置指定符。例如,它可以按句法的需要在芬氲氖焙蛑匦掳才啪渥咏峁埂
              format "We produced %d units in location %s" $num $city
              format "In location %s we produced %d units" $city $num

       可使用定位参数来处理:
              format "We produced %1\$d units in location %2\$s" $num $city
              format "In location %2\$s we produced %1\$d units" $num $city

       类似的,可以在 scan 中使用定位参数来提取国际化字符串中的值。

 CREDITS
       消息目录代码由 Mark Harrison 开发。

 SEE ALSO
       format(n), scan(n), namespace(n), package(n)

 KEYWORDS
       internationalization,  i18n,   localization,   l10n,   message,   text,
       translation

[[2001/10/12

 Linux man:
       http://cmpp.linuxforum.net