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 3c55a9c210
commit e5dc7a06a9
No known key found for this signature in database
GPG key ID: C3336907360768E1

View file

@ -397,6 +397,7 @@
</argument>
<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].
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.
[codeblock]
class MyCustomSorter: