Locale (クラス)
public sealed Locale {inherits ProcessResourceReclaimer}
パッケージ: CURL.RUNTIME.LOCALE

各国語対応に備えてロケール固有の情報を保持します。

説明

Locale では、言語と国に基づいて情報のフォーマットと表示を行うためのユーザー設定を定義します。

コンストラクタ
default:指定された引数に基づいて Locale オブジェクトを返します。
ファクトリ public implicit {Locale.default
name:String,
country:#String = null,
variant:#String = null,
strict?:bool = false
}:Locale
from-rfc1766-name:
ファクトリ deprecated public {Locale.from-rfc1766-name
name:String,
strict?:bool = false
}:Locale

プロパティ
language:Locale.name の「言語」部分。
フィールド public constant Locale.language:String
name:Locale の名前。
フィールド public constant Locale.name:String
rfc1766-name:
アクセサ deprecated public final Locale.rfc1766-name:String

クラス プロシージャ
get-available-locales:クライアント マシンで利用可能なすべてのロケール情報に対応する Locale オブジェクトの配列を返します。
public {Locale.get-available-locales}:{ReadOnlyArray-of Locale}

メソッド
メソッド 継承 Object: object-describe, object-describe-for-debugging, object-serialize



コンストラクタ詳細
default (ファクトリ)
public implicit {Locale.default
name:String,
country:#String = null,
variant:#String = null,
strict?:bool = false
}:Locale

指定された引数に基づいて Locale オブジェクトを返します。

説明

name は、country および variant (またはそのどちらか) により変更され、すべての使用可能なロケールに一致し、ホスト特有 (Win32 における大文字と小文字の区別のないこと、または linux における下線の許可など) に従い、最も適切な Locale が返されます。
name: "en-US.UTF-8" または "ja-JP" などの名前、または特別な名前 "curl"、または "en" などの言語。名前と言語に対する標準値の説明については、Locale.name を参照してください。
country: オプションの国別コード (Locale.name を参照)。null ではない場合、これはハイフンに続いて、名前に追加されます。
variant: オプションのベンダー固有かつブラウザ固有のバリアント コード。null ではない場合、これはハイフンに続いて、名前に追加されます。
strict?: 通常、指定された名前が何らかの既知のロケール (大文字と小文字の区別なし) に完全に一致しない場合、同じ言語 (または使用できる言語がない場合、ホスト ロケール) のいくつかの既存ロケールが使用されます。ただし、strict? が true の場合、LocaleNotFoundException がスローされます。呼び出し元は、結果の Locale オブジェクトの実際の名前を検査することに注意してください (Locale.name を使用)。

注意事項

country または variant なしに名前 "curl" を使用すると、Curl 構文ロケール (get-syntax-locale を参照) が返される場合があります。

注意事項

strict?true でない限り、返されるロケールは常に指定された言語を持ちますが、指定された言語以外の countryvariant を持つこともあります。 strict?true でない限り、正しい言語を持つシステム ロケールが存在しない場合には、指定された言語と "ZZ" の国に基づく統合的なロケールが返されます。これらの統合的なロケールは、名前を除いてホスト ロケールと同じになります。

これは暗黙的なファクトリーなので、Locale が要求される場合にはいつでも Locale 名を使用できます。
{format locale = "en", "%s", {DateTime}}
{format "%s", {DateTime}}


from-rfc1766-name (ファクトリ)
deprecated public {Locale.from-rfc1766-name
name:String,
strict?:bool = false
}:Locale

非推奨

代わりに Locale.default#factory を使用します。



プロパティ詳細
language (フィールド)
public constant Locale.language:String

Locale.name の「言語」部分。



name (フィールド)
public constant Locale.name:String

Locale の名前。

説明

Locale の名前は基本的に、RFC-1766 により記述されます。
名前は "<language>[-<subtag>]" の形式になります。
言語は常に小文字になり、単一文字 (i または x)、または言語コード (通常、2 または 3 文字の長さ。ISO-639 を参照)、または、RFC-1766 に対する特殊な拡張、Curl 構文ロケール (get-syntax-locale を参照) により使用される "curl" になります。
サブタグ (存在する場合) は、ハイフンにより言語と区切られ、通常、国別コード、または国別コードとオプションのバリアント指定により、構成されます。国別コードは常に大文字で表示され、通常、2 文字の長さになります。
たとえば、"en" または "ja-JP" または "en-US.UTF-8" です。

注意事項

Curl 構文ロケール (get-syntax-locale を参照) は特別で、名前は常に "curl" になり、サブタグを持つことはありません。


rfc1766-name (アクセサ)
アクセサ deprecated public final Locale.rfc1766-name:String

非推奨

代わりに Locale.name を使用します。




クラス プロシージャ詳細
get-available-locales (クラスプロシージャ)
public {Locale.get-available-locales}:{ReadOnlyArray-of Locale}

クライアント マシンで利用可能なすべてのロケール情報に対応する Locale オブジェクトの配列を返します。




メソッド詳細