137 lines
2.5 KiB
YAML
137 lines
2.5 KiB
YAML
|
name: IcuVersion
|
||
|
|
class_comment: '# * Facilitates the comparison of ICU version strings.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * @author Bernhard Schussek <bschussek@gmail.com>'
|
||
|
|
dependencies: []
|
||
|
|
properties: []
|
||
|
|
methods:
|
||
|
|
- name: compare
|
||
|
|
visibility: public
|
||
|
|
parameters:
|
||
|
|
- name: version1
|
||
|
|
- name: version2
|
||
|
|
- name: operator
|
||
|
|
- name: precision
|
||
|
|
default: 'null'
|
||
|
|
comment: '# * Facilitates the comparison of ICU version strings.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * @author Bernhard Schussek <bschussek@gmail.com>
|
||
|
|
|
||
|
|
# */
|
||
|
|
|
||
|
|
# class IcuVersion
|
||
|
|
|
||
|
|
# {
|
||
|
|
|
||
|
|
# /**
|
||
|
|
|
||
|
|
# * Compares two ICU versions with an operator.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * This method is identical to {@link version_compare()}, except that you
|
||
|
|
|
||
|
|
# * can pass the number of regarded version components in the last argument
|
||
|
|
|
||
|
|
# * $precision.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * Also, a single digit release version and a single digit major version
|
||
|
|
|
||
|
|
# * are contracted to a two digit release version. If no major version
|
||
|
|
|
||
|
|
# * is given, it is substituted by zero.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * Examples:
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::compare(''1.2.3'', ''1.2.4'', ''=='')
|
||
|
|
|
||
|
|
# * // => false
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::compare(''1.2.3'', ''1.2.4'', ''=='', 2)
|
||
|
|
|
||
|
|
# * // => true
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::compare(''1.2.3'', ''12.3'', ''=='')
|
||
|
|
|
||
|
|
# * // => true
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::compare(''1'', ''10'', ''=='')
|
||
|
|
|
||
|
|
# * // => true
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * @param int|null $precision The number of components to compare. Pass
|
||
|
|
|
||
|
|
# * NULL to compare the versions unchanged.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * @see normalize()'
|
||
|
|
- name: normalize
|
||
|
|
visibility: public
|
||
|
|
parameters:
|
||
|
|
- name: version
|
||
|
|
- name: precision
|
||
|
|
comment: '# * Normalizes a version string to the number of components given in the
|
||
|
|
|
||
|
|
# * parameter $precision.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * A single digit release version and a single digit major version are
|
||
|
|
|
||
|
|
# * contracted to a two digit release version. If no major version is given,
|
||
|
|
|
||
|
|
# * it is substituted by zero.
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * Examples:
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::normalize(''1.2.3.4'');
|
||
|
|
|
||
|
|
# * // => ''12.3.4''
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::normalize(''1.2.3.4'', 1);
|
||
|
|
|
||
|
|
# * // => ''12''
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * IcuVersion::normalize(''1.2.3.4'', 2);
|
||
|
|
|
||
|
|
# * // => ''12.3''
|
||
|
|
|
||
|
|
# *
|
||
|
|
|
||
|
|
# * @param int|null $precision The number of components to include. Pass
|
||
|
|
|
||
|
|
# * NULL to return the version unchanged.'
|
||
|
|
- name: __construct
|
||
|
|
visibility: private
|
||
|
|
parameters: []
|
||
|
|
comment: '# * Must not be instantiated.'
|
||
|
|
traits: []
|
||
|
|
interfaces: []
|