Implement bsearch for Vector and Packed*Array
This commit is contained in:
parent
0e5b0c025c
commit
214bbfbefe
14 changed files with 182 additions and 30 deletions
67
core/templates/search_array.h
Normal file
67
core/templates/search_array.h
Normal file
|
@ -0,0 +1,67 @@
|
|||
/*************************************************************************/
|
||||
/* search_array.h */
|
||||
/*************************************************************************/
|
||||
/* This file is part of: */
|
||||
/* GODOT ENGINE */
|
||||
/* https://godotengine.org */
|
||||
/*************************************************************************/
|
||||
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
|
||||
/* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
|
||||
/* */
|
||||
/* Permission is hereby granted, free of charge, to any person obtaining */
|
||||
/* a copy of this software and associated documentation files (the */
|
||||
/* "Software"), to deal in the Software without restriction, including */
|
||||
/* without limitation the rights to use, copy, modify, merge, publish, */
|
||||
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
||||
/* permit persons to whom the Software is furnished to do so, subject to */
|
||||
/* the following conditions: */
|
||||
/* */
|
||||
/* The above copyright notice and this permission notice shall be */
|
||||
/* included in all copies or substantial portions of the Software. */
|
||||
/* */
|
||||
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
||||
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
||||
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
||||
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
||||
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
||||
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
||||
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
||||
/*************************************************************************/
|
||||
|
||||
#ifndef SEARCH_ARRAY_H
|
||||
#define SEARCH_ARRAY_H
|
||||
|
||||
#include <core/templates/sort_array.h>
|
||||
|
||||
template <class T, class Comparator = _DefaultComparator<T>>
|
||||
class SearchArray {
|
||||
public:
|
||||
Comparator compare;
|
||||
|
||||
inline int bisect(const T *p_array, int p_len, const T &p_value, bool p_before) const {
|
||||
int lo = 0;
|
||||
int hi = p_len;
|
||||
if (p_before) {
|
||||
while (lo < hi) {
|
||||
const int mid = (lo + hi) / 2;
|
||||
if (compare(p_array[mid], p_value)) {
|
||||
lo = mid + 1;
|
||||
} else {
|
||||
hi = mid;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
while (lo < hi) {
|
||||
const int mid = (lo + hi) / 2;
|
||||
if (compare(p_value, p_array[mid])) {
|
||||
hi = mid;
|
||||
} else {
|
||||
lo = mid + 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
return lo;
|
||||
}
|
||||
};
|
||||
|
||||
#endif // SEARCH_ARRAY_H
|
|
@ -40,6 +40,7 @@
|
|||
#include "core/error/error_macros.h"
|
||||
#include "core/os/memory.h"
|
||||
#include "core/templates/cowdata.h"
|
||||
#include "core/templates/search_array.h"
|
||||
#include "core/templates/sort_array.h"
|
||||
|
||||
template <class T>
|
||||
|
@ -112,6 +113,11 @@ public:
|
|||
sort_custom<_DefaultComparator<T>>();
|
||||
}
|
||||
|
||||
int bsearch(const T &p_value, bool p_before) {
|
||||
SearchArray<T> search;
|
||||
return search.bisect(ptrw(), size(), p_value, p_before);
|
||||
}
|
||||
|
||||
Vector<T> duplicate() {
|
||||
return *this;
|
||||
}
|
||||
|
|
|
@ -34,6 +34,7 @@
|
|||
#include "core/object/class_db.h"
|
||||
#include "core/object/script_language.h"
|
||||
#include "core/templates/hashfuncs.h"
|
||||
#include "core/templates/search_array.h"
|
||||
#include "core/templates/vector.h"
|
||||
#include "core/variant/callable.h"
|
||||
#include "core/variant/variant.h"
|
||||
|
@ -484,44 +485,19 @@ void Array::shuffle() {
|
|||
}
|
||||
}
|
||||
|
||||
template <typename Less>
|
||||
_FORCE_INLINE_ int bisect(const Vector<Variant> &p_array, const Variant &p_value, bool p_before, const Less &p_less) {
|
||||
int lo = 0;
|
||||
int hi = p_array.size();
|
||||
if (p_before) {
|
||||
while (lo < hi) {
|
||||
const int mid = (lo + hi) / 2;
|
||||
if (p_less(p_array.get(mid), p_value)) {
|
||||
lo = mid + 1;
|
||||
} else {
|
||||
hi = mid;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
while (lo < hi) {
|
||||
const int mid = (lo + hi) / 2;
|
||||
if (p_less(p_value, p_array.get(mid))) {
|
||||
hi = mid;
|
||||
} else {
|
||||
lo = mid + 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
return lo;
|
||||
}
|
||||
|
||||
int Array::bsearch(const Variant &p_value, bool p_before) {
|
||||
ERR_FAIL_COND_V(!_p->typed.validate(p_value, "binary search"), -1);
|
||||
return bisect(_p->array, p_value, p_before, _ArrayVariantSort());
|
||||
SearchArray<Variant, _ArrayVariantSort> avs;
|
||||
return avs.bisect(_p->array.ptrw(), _p->array.size(), p_value, p_before);
|
||||
}
|
||||
|
||||
int Array::bsearch_custom(const Variant &p_value, Callable p_callable, bool p_before) {
|
||||
ERR_FAIL_COND_V(!_p->typed.validate(p_value, "custom binary search"), -1);
|
||||
|
||||
_ArrayVariantSortCustom less;
|
||||
less.func = p_callable;
|
||||
SearchArray<Variant, _ArrayVariantSortCustom> avs;
|
||||
avs.compare.func = p_callable;
|
||||
|
||||
return bisect(_p->array, p_value, p_before, less);
|
||||
return avs.bisect(_p->array.ptrw(), _p->array.size(), p_value, p_before);
|
||||
}
|
||||
|
||||
void Array::reverse() {
|
||||
|
|
|
@ -1839,6 +1839,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedByteArray, reverse, sarray(), varray());
|
||||
bind_method(PackedByteArray, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedByteArray, sort, sarray(), varray());
|
||||
bind_method(PackedByteArray, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedByteArray, duplicate, sarray(), varray());
|
||||
|
||||
bind_function(PackedByteArray, get_string_from_ascii, _VariantCall::func_PackedByteArray_get_string_from_ascii, sarray(), varray());
|
||||
|
@ -1900,6 +1901,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedInt32Array, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedInt32Array, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedInt32Array, sort, sarray(), varray());
|
||||
bind_method(PackedInt32Array, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedInt32Array, duplicate, sarray(), varray());
|
||||
|
||||
/* Int64 Array */
|
||||
|
@ -1919,6 +1921,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedInt64Array, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedInt64Array, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedInt64Array, sort, sarray(), varray());
|
||||
bind_method(PackedInt64Array, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedInt64Array, duplicate, sarray(), varray());
|
||||
|
||||
/* Float32 Array */
|
||||
|
@ -1938,6 +1941,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedFloat32Array, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedFloat32Array, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedFloat32Array, sort, sarray(), varray());
|
||||
bind_method(PackedFloat32Array, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedFloat32Array, duplicate, sarray(), varray());
|
||||
|
||||
/* Float64 Array */
|
||||
|
@ -1957,6 +1961,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedFloat64Array, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedFloat64Array, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedFloat64Array, sort, sarray(), varray());
|
||||
bind_method(PackedFloat64Array, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedFloat64Array, duplicate, sarray(), varray());
|
||||
|
||||
/* String Array */
|
||||
|
@ -1976,6 +1981,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedStringArray, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedStringArray, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedStringArray, sort, sarray(), varray());
|
||||
bind_method(PackedStringArray, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedStringArray, duplicate, sarray(), varray());
|
||||
|
||||
/* Vector2 Array */
|
||||
|
@ -1995,6 +2001,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedVector2Array, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedVector2Array, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedVector2Array, sort, sarray(), varray());
|
||||
bind_method(PackedVector2Array, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedVector2Array, duplicate, sarray(), varray());
|
||||
|
||||
/* Vector3 Array */
|
||||
|
@ -2014,6 +2021,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedVector3Array, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedVector3Array, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedVector3Array, sort, sarray(), varray());
|
||||
bind_method(PackedVector3Array, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedVector3Array, duplicate, sarray(), varray());
|
||||
|
||||
/* Color Array */
|
||||
|
@ -2033,6 +2041,7 @@ static void _register_variant_builtin_methods() {
|
|||
bind_method(PackedColorArray, subarray, sarray("from", "to"), varray());
|
||||
bind_method(PackedColorArray, to_byte_array, sarray(), varray());
|
||||
bind_method(PackedColorArray, sort, sarray(), varray());
|
||||
bind_method(PackedColorArray, bsearch, sarray("value", "before"), varray(true));
|
||||
bind_method(PackedColorArray, duplicate, sarray(), varray());
|
||||
|
||||
/* Register constants */
|
||||
|
|
|
@ -43,6 +43,15 @@
|
|||
Appends a [PackedByteArray] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="int" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="compress" qualifiers="const">
|
||||
<return type="PackedByteArray" />
|
||||
<argument index="0" name="compression_mode" type="int" default="0" />
|
||||
|
|
|
@ -43,6 +43,15 @@
|
|||
Appends a [PackedColorArray] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="Color" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedColorArray" />
|
||||
<description>
|
||||
|
|
|
@ -44,6 +44,15 @@
|
|||
Appends a [PackedFloat32Array] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="float" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedFloat32Array" />
|
||||
<description>
|
||||
|
|
|
@ -44,6 +44,15 @@
|
|||
Appends a [PackedFloat64Array] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="float" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedFloat64Array" />
|
||||
<description>
|
||||
|
|
|
@ -44,6 +44,15 @@
|
|||
Appends a [PackedInt32Array] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="int" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedInt32Array" />
|
||||
<description>
|
||||
|
|
|
@ -44,6 +44,15 @@
|
|||
Appends a [PackedInt64Array] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="int" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedInt64Array" />
|
||||
<description>
|
||||
|
|
|
@ -44,6 +44,15 @@
|
|||
Appends a [PackedStringArray] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="String" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedStringArray" />
|
||||
<description>
|
||||
|
|
|
@ -44,6 +44,15 @@
|
|||
Appends a [PackedVector2Array] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="Vector2" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedVector2Array" />
|
||||
<description>
|
||||
|
|
|
@ -43,6 +43,15 @@
|
|||
Appends a [PackedVector3Array] at the end of this array.
|
||||
</description>
|
||||
</method>
|
||||
<method name="bsearch">
|
||||
<return type="int" />
|
||||
<argument index="0" name="value" type="Vector3" />
|
||||
<argument index="1" name="before" type="bool" default="true" />
|
||||
<description>
|
||||
Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a [code]before[/code] specifier can be passed. If [code]false[/code], the returned index comes after all existing entries of the value in the array.
|
||||
[b]Note:[/b] Calling [method bsearch] on an unsorted array results in unexpected behavior.
|
||||
</description>
|
||||
</method>
|
||||
<method name="duplicate">
|
||||
<return type="PackedVector3Array" />
|
||||
<description>
|
||||
|
|
|
@ -472,6 +472,19 @@ TEST_CASE("[Vector] Sort custom") {
|
|||
CHECK(vector[7] == "World");
|
||||
}
|
||||
|
||||
TEST_CASE("[Vector] Search") {
|
||||
Vector<int> vector;
|
||||
vector.push_back(1);
|
||||
vector.push_back(2);
|
||||
vector.push_back(3);
|
||||
vector.push_back(5);
|
||||
vector.push_back(8);
|
||||
CHECK(vector.bsearch(2, true) == 1);
|
||||
CHECK(vector.bsearch(2, false) == 2);
|
||||
CHECK(vector.bsearch(5, true) == 3);
|
||||
CHECK(vector.bsearch(5, false) == 4);
|
||||
}
|
||||
|
||||
TEST_CASE("[Vector] Operators") {
|
||||
Vector<int> vector;
|
||||
vector.push_back(2);
|
||||
|
|
Loading…
Reference in a new issue