Improve sort_custom() description

(cherry picked from commit 48f0368ddc)
This commit is contained in:
kobewi 2021-06-03 17:41:02 +02:00 committed by Rémi Verschelde
parent f5fe8ddacc
commit 457ccb21b6
No known key found for this signature in database
GPG key ID: C3336907360768E1

View file

@ -397,6 +397,7 @@
</argument> </argument>
<description> <description>
Sorts the array using a custom method. The arguments are an object that holds the method and the name of such method. The custom method receives two arguments (a pair of elements from the array) and must return either [code]true[/code] or [code]false[/code]. Sorts the array using a custom method. The arguments are an object that holds the method and the name of such method. The custom method receives two arguments (a pair of elements from the array) and must return either [code]true[/code] or [code]false[/code].
For two elements [code]a[/code] and [code]b[/code], if the given method returns [code]true[/code], element [code]b[/code] will be after element [code]a[/code] in the array.
[b]Note:[/b] you cannot randomize the return value as the heapsort algorithm expects a deterministic result. Doing so will result in unexpected behavior. [b]Note:[/b] you cannot randomize the return value as the heapsort algorithm expects a deterministic result. Doing so will result in unexpected behavior.
[codeblock] [codeblock]
class MyCustomSorter: class MyCustomSorter: