diff --git a/reference/intl/dateformatter/localtime.xml b/reference/intl/dateformatter/localtime.xml index 2c2319f78e9..0fbbc35619a 100644 --- a/reference/intl/dateformatter/localtime.xml +++ b/reference/intl/dateformatter/localtime.xml @@ -1,6 +1,6 @@ - + IntlDateFormatter::localtime @@ -26,11 +26,11 @@ stringstring intoffset&null; - - 文字列 $value を変換し、フィールドベースの時刻値 (各フィールドを含む配列) - にします。$parse_pos からパースを開始し、入力値を可能な限り使用します。 - - + + string を変換し、フィールドベースの時刻値 (各フィールドを含む配列) + にします。offset からパースを開始し、入力文字列を可能な限り使用します。 + + &reftitle.parameters; @@ -39,46 +39,46 @@ formatter - - Formatter リソース。 - + + IntlDateFormatter オブジェクト。 + string - + 時間に変換する文字列。 - + offset - - $value のパースを開始する位置 (ゼロから数えます)。 - $value を最後まで処理してもエラーが発生しなかった場合は - $parse_pos は -1 となります。それ以外の場合はパースが終了した位置となります - (そしてエラーが発生します)。 - この変数には、パースが失敗した場合にその終了位置が含まれます。 - $parse_pos > strlen($value) の場合、パースは即時に失敗します。 - + + string のパースを開始する位置 (ゼロから数えます)。 + 呼び出し後は、パースが成功したかどうかにかかわらず、 + offset にパースが終了した位置が格納されます。 + offset が負の値の場合、または strlen($string) + より大きい場合は、パースは即座に失敗し、 + offset は変更されません。 + - - + &reftitle.returnvalues; - - Localtime 互換の、整数値の配列を返します。 - tm_hour フィールド内の、24 時間制の時刻の値を含みます。 - &return.falseforfailure; - + + localtime と同じキーを持つ、整数値の連想配列を返します。 + 24 時間制の時間が tm_hour に格納されます。&return.falseforfailure;。 + tm_yday は、localtime が 0 から始まる値を返すのに対し、 + ここでは 1 から始まる点に注意してください。 + - + &reftitle.examples; @@ -94,7 +94,9 @@ $fmt = datefmt_create( 'America/Los_Angeles', IntlDateFormatter::GREGORIAN ); + $arr = datefmt_localtime($fmt, 'Wednesday, December 31, 1969 at 4:00:00 PM Pacific Standard Time', $offset); + echo 'First parsed output is '; if ($arr) { foreach ($arr as $key => $value) { @@ -111,6 +113,7 @@ if ($arr) { localtime('Wednesday, December 31, 1969 at 4:00:00 PM Pacific Standard Time', $offset); + echo 'First parsed output is '; if ($arr) { foreach ($arr as $key => $value) { diff --git a/reference/intl/dateformatter/parse.xml b/reference/intl/dateformatter/parse.xml index e972a3c12df..9835290fd40 100644 --- a/reference/intl/dateformatter/parse.xml +++ b/reference/intl/dateformatter/parse.xml @@ -1,6 +1,6 @@ - + IntlDateFormatter::parse @@ -39,9 +39,9 @@ formatter - - Formatter リソース。 - + + IntlDateFormatter オブジェクト。 + @@ -55,14 +55,14 @@ offset - + string のパースを開始する位置 (ゼロから数えます)。 - string を最後まで処理してもエラーが発生しなかった場合は - offset は -1 となります。それ以外の場合はパースが終了した位置となります - (そしてエラーが発生します)。 - この変数には、パースが失敗した場合にその終了位置が含まれます。 - offset > strlen($string) の場合、パースは即時に失敗します。 - + 呼び出し後は、パースが成功したかどうかにかかわらず、 + offset にパースが終了した位置が格納されます。 + offset が負の値の場合、または strlen($string) + より大きい場合は、パースは即座に失敗し、 + offset は変更されません。 + diff --git a/reference/intl/dateformatter/parsetocalendar.xml b/reference/intl/dateformatter/parsetocalendar.xml index fab0361bce6..98188fe1d34 100644 --- a/reference/intl/dateformatter/parsetocalendar.xml +++ b/reference/intl/dateformatter/parsetocalendar.xml @@ -1,6 +1,6 @@ - + IntlDateFormatter::parseToCalendar @@ -40,11 +40,10 @@ string のパースを開始する位置 (ゼロから数えます)。 - string を最後まで処理してもエラーが発生しなかった場合、 - offset は -1 となります。それ以外の場合は、 - パースが終了した (そしてエラーが発生した) 位置となります。 - パースが失敗した場合、この変数にはその終了位置が格納されます。 - offset > strlen($string) の場合、パースは即時に失敗します。 + 呼び出し後は、パースが成功したかどうかにかかわらず、 + offset にパースが終了した位置が格納されます。 + offset が strlen($string) + より大きい場合は、パースは即座に失敗し、offset は変更されません。 diff --git a/reference/intl/grapheme/grapheme-levenshtein.xml b/reference/intl/grapheme/grapheme-levenshtein.xml new file mode 100644 index 00000000000..da6c8e873a7 --- /dev/null +++ b/reference/intl/grapheme/grapheme-levenshtein.xml @@ -0,0 +1,219 @@ + + + + + + grapheme_levenshtein + 二つの文字列のレーベンシュタイン距離を書記素単位で計算する + + + &reftitle.description; + &style.procedural; + + intfalsegrapheme_levenshtein + stringstring1 + stringstring2 + intinsertion_cost1 + intreplacement_cost1 + intdeletion_cost1 + stringlocale"" + + + レーベンシュタイン距離は、string1 を + string2 に変換するために置換、挿入、削除 + しなければならない書記素クラスターの最小数として定義されます。 + アルゴリズムの計算量は O(m*n) です。 + ここで、n および m はそれぞれ + string1 および + string2 の書記素単位での長さです。 + + + バイト単位で動作する levenshtein とは異なり、 + この関数は Unicode の書記素クラスターを数えます。 + そのため、同じ文字の合成形式と分解形式 + (たとえば U+00E9 と + U+0065 U+0301 は、どちらも é を表します) + は等価なものとして扱われ、距離はゼロになります。 + + + insertion_cost、replacement_cost + かつ/または deletion_cost が 1 以外の場合、 + アルゴリズムは最もコストの小さい変換を選ぶように動作します。 + たとえば、$insertion_cost + $deletion_cost < $replacement_cost の場合、 + 置換をせず、挿入と削除が行われます。 + + + + + &reftitle.parameters; + + + + string1 + + + レーベンシュタイン距離を計算する文字列のひとつ。 + 有効な UTF-8 でなければなりません。 + + + + + string2 + + + レーベンシュタイン距離を計算する文字列のひとつ。 + 有効な UTF-8 でなければなりません。 + + + + + insertion_cost + + + 挿入のコストを指定します。0 より大きくなければなりません。 + + + + + replacement_cost + + + 置換のコストを指定します。0 より大きくなければなりません。 + + + + + deletion_cost + + + 削除のコストを指定します。0 より大きくなければなりません。 + + + + + locale + + &intl.param.grapheme.locale; + + + + + + + + &reftitle.returnvalues; + + 二つの文字列のレーベンシュタイン距離を書記素単位で返します。 + 失敗した場合は &false; を返します。 + 失敗の詳細を取得するには intl_get_error_message + を使用します。 + + + + + &reftitle.errors; + + insertion_cost、replacement_cost、 + deletion_cost のいずれかが 0 以下の場合、 + ValueError をスローします。 + + + 入力文字列のいずれかが有効な UTF-8 でない場合、 + locale が正しいロケール識別子でない場合、 + あるいは ICU の内部エラーが発生した場合は、 + &false; を返し、intl のエラーを設定します。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + この関数が追加されました。 + + + + + + + + + &reftitle.examples; + + <function>grapheme_levenshtein</function> の例 + + +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + + levenshtein + grapheme_strlen + grapheme_substr + similar_text + + + Unicode Text Segmentation: Grapheme Cluster Boundaries + + + + + + + diff --git a/reference/intl/intlchar/charfromname.xml b/reference/intl/intlchar/charfromname.xml index 23f9ae0c54b..2f940d21107 100644 --- a/reference/intl/intlchar/charfromname.xml +++ b/reference/intl/intlchar/charfromname.xml @@ -1,6 +1,6 @@ - + IntlChar::charFromName @@ -21,13 +21,13 @@ 指定する名前は、完全、かつ正確なマッチが行われます。 名前がコードポイントに対応していない場合は、&null; を返します。 - + Unicode 1.0 の名前は、 それ以降の "modern" name と異なる場合のみマッチします。 Unicode の名前は、全て大文字です。 - 拡張名は小文字ではじまり、その後に大文字の16進の数値が続き、 - そしてそれを鉤括弧で囲んだものです。 - + 拡張名は小文字ではじまり、その後にハイフンと大文字の16進の数値が続き、 + それを山括弧で囲んだものです。 + @@ -75,10 +75,14 @@ ", IntlChar::EXTENDED_CHAR_NAME)); + ?> ]]> @@ -89,6 +93,7 @@ int(65) int(9731) int(9843) NULL +int(8) ]]> diff --git a/reference/intl/intlgregoriancalendar/getgregorianchange.xml b/reference/intl/intlgregoriancalendar/getgregorianchange.xml index 356896b8608..702e29c8857 100644 --- a/reference/intl/intlgregoriancalendar/getgregorianchange.xml +++ b/reference/intl/intlgregoriancalendar/getgregorianchange.xml @@ -1,6 +1,6 @@ - + IntlGregorianCalendar::getGregorianChange @@ -9,21 +9,34 @@ &reftitle.description; + &style.oop; public floatIntlGregorianCalendar::getGregorianChange - - - - - &warn.undocumented.func; - + &style.procedural; + + floatintlgregcal_get_gregorian_change + IntlGregorianCalendarcalendar + + + グレゴリオ暦への切換え日を取得します。 + これは、カレンダーがユリウス暦の日付からグレゴリオ暦の日付に切り替わる時点を、 + ミリ秒単位の Unix タイムスタンプで表したものです。 + デフォルトは 1582 年 10 月 15 日の深夜 0 時 (UTC) です。 + &reftitle.parameters; - &no.function.parameters; + + + calendar + + IntlGregorianCalendar クラスのインスタンス。 + + + diff --git a/reference/intl/intlgregoriancalendar/isleapyear.xml b/reference/intl/intlgregoriancalendar/isleapyear.xml index 93cdd742ad4..d67a78a597d 100644 --- a/reference/intl/intlgregoriancalendar/isleapyear.xml +++ b/reference/intl/intlgregoriancalendar/isleapyear.xml @@ -1,6 +1,6 @@ - + IntlGregorianCalendar::isLeapYear @@ -9,27 +9,35 @@ &reftitle.description; + &style.oop; public boolIntlGregorianCalendar::isLeapYear intyear - - - - - &warn.undocumented.func; - + &style.procedural; + + boolintlgregcal_is_leap_year + IntlGregorianCalendarcalendar + intyear + + + 指定された year がグレゴリオ暦のうるう年かどうかを判定します。 + &reftitle.parameters; + + calendar + + IntlGregorianCalendar クラスのインスタンス。 + + year - - - + 判定する年。 diff --git a/reference/intl/intlgregoriancalendar/setgregorianchange.xml b/reference/intl/intlgregoriancalendar/setgregorianchange.xml index acd95d85132..35cff471119 100644 --- a/reference/intl/intlgregoriancalendar/setgregorianchange.xml +++ b/reference/intl/intlgregoriancalendar/setgregorianchange.xml @@ -1,6 +1,6 @@ - + IntlGregorianCalendar::setGregorianChange @@ -9,27 +9,38 @@ &reftitle.description; + &style.oop; public boolIntlGregorianCalendar::setGregorianChange floattimestamp - - - - - &warn.undocumented.func; - + &style.procedural; + + boolintlgregcal_set_gregorian_change + IntlGregorianCalendarcalendar + floattimestamp + + + グレゴリオ暦への切換え日を設定します。これは、カレンダーがユリウス暦の日付から + グレゴリオ暦の日付に切り替わる時点を、ミリ秒単位の Unix タイムスタンプで表したものです。 + &reftitle.parameters; + + calendar + + IntlGregorianCalendar クラスのインスタンス。 + + timestamp - - - + + グレゴリオ暦への切換え日。ミリ秒単位の Unix タイムスタンプで指定します。 + diff --git a/reference/intl/locale.xml b/reference/intl/locale.xml index 6ec130f5580..151317dbd0d 100644 --- a/reference/intl/locale.xml +++ b/reference/intl/locale.xml @@ -1,6 +1,6 @@ - + Locale クラス Locale @@ -37,6 +37,9 @@ Locale クラスのインスタンスを作成することはできません。 すべての関数/メソッドは :: を付けて呼び出します。 + ICU が使用するデフォルトのロケールを読み書きするには、 + Locale::getDefault と + Locale::setDefault を使用します。 null や空文字列は "root" ロケールとなります。 @@ -179,6 +182,14 @@ + + 8.5.0 + + ロケールを指定する引数に null バイトが含まれる場合、 + Locale のメソッドが + ValueError をスローするようになりました。 + + 8.4.0 diff --git a/reference/intl/locale/add-likely-subtags.xml b/reference/intl/locale/add-likely-subtags.xml new file mode 100644 index 00000000000..2df9d093133 --- /dev/null +++ b/reference/intl/locale/add-likely-subtags.xml @@ -0,0 +1,92 @@ + + + + + + Locale::addLikelySubtags + locale_add_likely_subtags + ロケールに、可能性の高いサブタグを追加する + + + + &reftitle.description; + + &style.oop; + + + public static stringfalseLocale::addLikelySubtags + stringlocale + + + &style.procedural; + + + stringfalselocale_add_likely_subtags + stringlocale + + + ICU のロケールデータに基づいて可能性の高いサブタグ (likely subtags) を追加し、 + ロケールタグを展開します。 + たとえば、en は en_Latn_US になります。 + + + + + &reftitle.parameters; + + + locale + + + 展開したいロケール。 + + + + + + + + &reftitle.returnvalues; + + 可能性の高いサブタグを追加したロケールを返します。 + 失敗した場合は &false; を返します。 + + + + + &reftitle.errors; + + locale 引数に null バイトが含まれる場合、 + ValueError をスローします。 + + + + + &reftitle.seealso; + + Locale::minimizeSubtags + Locale::canonicalize + + + + + diff --git a/reference/intl/locale/get-keywords.xml b/reference/intl/locale/get-keywords.xml index 3172c92c0f9..0a92477d966 100644 --- a/reference/intl/locale/get-keywords.xml +++ b/reference/intl/locale/get-keywords.xml @@ -1,6 +1,6 @@ - + @@ -37,9 +37,11 @@ locale - + キーワードを取り出したいロケール。 - + 空文字列を渡した場合は、代わりに + locale_get_default が返す値を使います。 + @@ -49,9 +51,10 @@ &reftitle.returnvalues; - + このロケールのキーワードと値のペアを連想配列で返します。 - + キーワードがない場合は &null;、失敗した場合は &false; を返します。 + &intl.locale-len.return; @@ -63,7 +66,7 @@ $value) { echo "$key = $value\n"; } @@ -78,7 +81,7 @@ if ($keywords_arr) { $value) { echo "$key = $value\n"; } @@ -101,6 +104,8 @@ currency = EUR locale_get_all_variants + locale_get_default + locale_set_default diff --git a/reference/intl/locale/minimize-subtags.xml b/reference/intl/locale/minimize-subtags.xml new file mode 100644 index 00000000000..53a46242a77 --- /dev/null +++ b/reference/intl/locale/minimize-subtags.xml @@ -0,0 +1,92 @@ + + + + + + Locale::minimizeSubtags + locale_minimize_subtags + ロケールから、可能性の高いサブタグを取り除く + + + + &reftitle.description; + + &style.oop; + + + public static stringfalseLocale::minimizeSubtags + stringlocale + + + &style.procedural; + + + stringfalselocale_minimize_subtags + stringlocale + + + ICU の likely subtag データを使って推測できるサブタグを取り除き、 + ロケールタグを最小化します。たとえば en_Latn_US は + en になります。 + + + + + &reftitle.parameters; + + + locale + + + 最小化するロケール。 + + + + + + + + &reftitle.returnvalues; + + 可能性の高いサブタグを取り除いたロケールを返します。 + 失敗した場合は &false; を返します。 + + + + + &reftitle.errors; + + locale 引数に null バイトが含まれる場合、 + ValueError をスローします。 + + + + + &reftitle.seealso; + + Locale::addLikelySubtags + Locale::canonicalize + + + + + diff --git a/reference/intl/locale/parse-locale.xml b/reference/intl/locale/parse-locale.xml index b5acd135f52..5cfb734798c 100644 --- a/reference/intl/locale/parse-locale.xml +++ b/reference/intl/locale/parse-locale.xml @@ -1,6 +1,6 @@ - + @@ -37,11 +37,13 @@ locale - + サブタグの配列を取り出したいロケール。 注意: サブタグ 'variant' と 'private' には最大で 15 の値を指定できますが、 'extlang' には最大で 3 つの値しか指定できません。 - + 空文字列を渡した場合は、代わりに + locale_get_default が返す値を使います。 + @@ -50,18 +52,15 @@ &reftitle.returnvalues; - + 連想配列を返します。キーがロケール ID サブタグを表し、 そのサブタグの値が関連付けられています。 この配列の並び順はロケール ID サブタグの順となります。変化形が - '-varX-varY-varZ' の場合、返される配列は - variant0=>varX , variant1=>varY , - variant2=>varZ のようになります。 - - - locale の長さが - INTL_MAX_LOCALE_LEN を超えた場合、&null; を返します。 - + -varX-varY-varZ の場合、返される配列は + variant0=>varX, variant1=>varY, + variant2=>varZ のようになります。 + + &intl.locale-len.return; @@ -100,6 +99,28 @@ if ($arr) { + + + 空文字列を渡すとデフォルトのロケールを使う例 + + $value) { + echo "$key : $value , "; + } +} +?> +]]> + + + &example.outputs; + + @@ -109,6 +130,8 @@ language : sl , script : Latn , region : IT , variant0 : NEDIS , locale_compose + locale_get_default + locale_set_default