diff --git a/docs/xml/lazutils/lazutf8.xml b/docs/xml/lazutils/lazutf8.xml index 3a39fad2e2..c244596187 100644 --- a/docs/xml/lazutils/lazutf8.xml +++ b/docs/xml/lazutils/lazutf8.xml @@ -2029,6 +2029,34 @@ MaxCol is set to 0 (zero), or BreakChars is an empty set. Maximum line width in number of UTF-8 characters. + + +Determines whether the specified string contains only single-byte ASCII +characters. + + +

+Used in the implementation of the TStringListUTF8Fast.InsertItem method. +

+
+ +Added in LazUtils version 3.2. + + + + +
+ + +Returns True if all of the characters in S have a value less than $7F. + + + + +String with the characters examined in the method. + + + Represents styles used to escape control characters. @@ -2320,7 +2348,7 @@ PChar with the values used in the comparison. -Like UTF8CompareText but does not return strict alphabetical order. +Deprecated. Use UTF8CompareText or AnsiCompareText instead.

@@ -2353,6 +2381,9 @@ the compared values is stored.

S1 and S2 have the same value in the sort order.
+ +Deprecated in LazUtils version 3.2 (Feb 2024). + AnsiCompareText @@ -2376,7 +2407,7 @@ UTF-8-encoded String value used in the comparison. -Compare two strings using language-specific sorting. +Deprecated. Use UTF8CompareStr instead.

@@ -2385,6 +2416,9 @@ language-specific sorting. The return value contains the relative sort order for the compared values, as defined for UTF8CompareStr.

+ +Deprecated in LazUtils version 3.2 (Feb 2024). +
@@ -2432,15 +2466,17 @@ defined for UTF8CompareText. Position of the second text line. + -Implements a string list using UTF8CompareLatinTextFast for comparisons. +Implements a string list using fast ASCII comparison functions when its data is +pure ASCII.

-TStringListUTF8Fast is a TStringList descendant which -uses UTF8CompareLatinTextFast for fast comparison of values in the class -instance. +When data is Unicode, it switches to slower AnsiCompare functions. The switch +is managed by setting the UseLocale property/option and should not be changed +by the user.

@@ -2448,45 +2484,45 @@ instance.
- + + -Compares UTF-8-encoded values using UTF8CompareLatinTextFast when case -sensitivity is not enabled. +Ensures that the UseLocale property is enabled when a new line with non-ASCII +data is stored in the string list. + + + + + + +Ordinal position in the string list where the value in S is stored. + + + + +String value examined and stored in the method. + + + + + +Constructor for the class instance.

-Calls the UTF8CompareLatinTextFast routine to compare the values in -s1 and s2 when the CaseSensitive property is set to -False. Otherwise, the Utf8CompareStr routine is called to compare the -string values. -

-

-The return value is a pointer to an Integer with the relative order for the -compared values. <0 indicates s1 comes before s2. 0 indicated the compared -values are the same. >0 indicates s2 comes after s1. +Create is the overridden constructor for the class instance. It +calls the inherited method on entry to set the default encoding and options +used in the class instance. Create ensures that the UseLocale property is set +to False to allow fast comparisons for ASCII data stored in the string +list.

- - -TStringList.CaseSensitive + +TStrings.UseLocale +TStrings.DefaultEncoding
- - -Pointer to an Integer with the relative order for the compared values. - - - - -String with a value used in the comparison. - - - - -String with a value used in the comparison. - -