reference/intl/collator/set-strength.xml
8eec6fe5573d8de8fa65ac04974c8b637d832753
8eec6fe5573d8de8fa65ac04974c8b637d832753
...
...
@@ -12,19 +12,16 @@
12
12
<para>
13
13
&style.oop;
14
14
</para>
15
-
<methodsynopsis>
16
-
<modifier>public</modifier>
17
-
<type>bool</type>
18
-
<methodname>Collator::setStrength</methodname>
15
+
<methodsynopsis role="Collator">
16
+
<modifier>public</modifier> <type>bool</type><methodname>Collator::setStrength</methodname>
19
17
<methodparam><type>int</type><parameter>strength</parameter></methodparam>
20
18
</methodsynopsis>
21
19
<para>
22
20
&style.procedural;
23
21
</para>
24
22
<methodsynopsis>
25
-
<type>bool</type>
26
-
<methodname>collator_set_strength</methodname>
27
-
<methodparam><type>Collator</type><parameter>coll</parameter></methodparam>
23
+
<type>bool</type><methodname>collator_set_strength</methodname>
24
+
<methodparam><type>Collator</type><parameter>object</parameter></methodparam>
28
25
<methodparam><type>int</type><parameter>strength</parameter></methodparam>
29
26
</methodsynopsis>
30
27
<para>
...
...
@@ -40,21 +37,21 @@
40
37
<orderedlist>
41
38
<listitem>
42
39
<para>
43
-
<emphasis> Primary Level</emphasis>:
40
+
<emphasis>Primary Level</emphasis>:
44
41
Typically, this is used to denote differences between base characters
45
42
(for example, "a" < "b"). It is the strongest difference. For
46
43
example, dictionaries are divided into different sections by base
47
-
character. This is also called the level1 strength.
44
+
character. This is also called the <literal>level 1</literal> strength.
48
45
</para>
49
46
</listitem>
50
47
<listitem>
51
48
<para>
52
-
<emphasis> Secondary Level</emphasis>:
49
+
<emphasis>Secondary Level</emphasis>:
53
50
Accents in the characters are considered secondary differences (for
54
51
example, "as" < "às" < "at"). Other differences between letters
55
52
can also be considered secondary differences, depending on the language.
56
53
A secondary difference is ignored when there is a primary difference
57
-
anywhere in the strings. This is also called the level2 strength.
54
+
anywhere in the strings. This is also called the <literal>level 2</literal> strength.
58
55
<note>
59
56
<para>
60
57
Note: In some languages (such as Danish), certain accented letters are
...
...
@@ -67,40 +64,40 @@
67
64
</listitem>
68
65
<listitem>
69
66
<para>
70
-
<emphasis> Tertiary Level</emphasis>:
67
+
<emphasis>Tertiary Level</emphasis>:
71
68
Upper and lower case differences in characters are distinguished at
72
69
the tertiary level (for example, "ao" < "Ao" < "aò"). In addition,
73
70
a variant of a letter differs from the base form on the tertiary level
74
-
(such as "A" and " "). Another example is the difference between large
71
+
(such as "a" and "𝒶"). Another example is the difference between large
75
72
and small Kana. A tertiary difference is ignored when there is a primary
76
73
or secondary difference anywhere in the strings. This is also called the
77
-
level3 strength.
74
+
<literal>level 3</literal> strength.
78
75
</para>
79
76
</listitem>
80
77
<listitem>
81
78
<para>
82
-
<emphasis> Quaternary Level</emphasis>:
83
-
When punctuation is ignored (see Ignoring Punctuations ) at level 13,
79
+
<emphasis>Quaternary Level</emphasis>:
80
+
When punctuation is ignored (see Ignoring Punctuations ) at levels 1-3,
84
81
an additional level can be used to distinguish words with and without
85
82
punctuation (for example, "ab" < "a-b" < "aB"). This difference is
86
83
ignored when there is a primary, secondary or tertiary difference. This
87
-
is also known as the level4 strength. The quaternary level should only
84
+
is also known as the <literal>level 4</literal> strength. The quaternary level should only
88
85
be used if ignoring punctuation is required or when processing Japanese
89
86
text (see Hiragana processing).
90
87
</para>
91
88
</listitem>
92
89
<listitem>
93
90
<para>
94
-
<emphasis> Identical Level</emphasis>:
91
+
<emphasis>Identical Level</emphasis>:
95
92
When all other levels are equal, the identical level is used as a
96
93
tiebreaker. The Unicode code point values of the NFD form of each string
97
94
are compared at this level, just in case there is no difference at
98
-
levels 14. For example, Hebrew cantillation marks are only distinguished
95
+
levels 1-4. For example, Hebrew cantillation marks are only distinguished
99
96
at this level. This level should be used sparingly, as only code point
100
97
values differences between two strings is an extremely rare occurrence.
101
98
Using this level substantially decreases the performance for both
102
99
incremental comparison and sort key generation (as well as increasing
103
-
the sort key length). It is also known as level 5 strength.
100
+
the sort key length). It is also known as <literal>level 5</literal> strength.
104
101
</para>
105
102
</listitem>
106
103
</orderedlist>
...
...
@@ -125,7 +122,7 @@
125
122
<para>
126
123
<variablelist>
127
124
<varlistentry>
128
-
<term><parameter>coll</parameter></term>
125
+
<term><parameter>object</parameter></term>
129
126
<listitem>
130
127
<para>
131
128
<classname>Collator</classname> object.
...
...
@@ -235,7 +232,6 @@ array (
235
232
</para>
236
233
</refsect1>
237
234
</refentry>
238
-
239
235
<!-- Keep this comment at the end of the file
240
236
Local variables:
241
237
mode: sgml
242
238