Expose vec/arr to string functions in VectorND

Author: aaronfranke

addons/nd/doc_classes/VectorND.xml

@@ -40,6 +40,13 @@
 				Returns the angle in radians between two N-dimensional vectors. The dimensions of the vectors do not need to match.
 			</description>
 		</method>
+		<method name="arr_to_string" qualifiers="static">
+			<return type="String" />
+			<param index="0" name="vectors" type="PackedFloat64Array[]" />
+			<description>
+				Converts an array of VectorN (array of [PackedFloat64Array]) to a string representation, with the outer brackets denoting the array and inner parenthesis denoting each vector. For example, [code][(1.0, 2.0), (3.0, 4.0)][/code].
+			</description>
+		</method>
 		<method name="average" qualifiers="static">
 			<return type="PackedFloat64Array" />
 			<param index="0" name="vectors" type="PackedFloat64Array[]" />
@@ -475,6 +482,13 @@
 				Returns a new VectorN ([PackedFloat64Array]) that has the value of [param value] on the given [param axis] index, and [code]0.0[/code] on all axes with lower indices.
 			</description>
 		</method>
+		<method name="vec_to_string" qualifiers="static">
+			<return type="String" />
+			<param index="0" name="vector" type="PackedFloat64Array" />
+			<description>
+				Converts the given VectorN ([PackedFloat64Array]) to a string representation. For example, [code][1.0, 2.0, 3.0][/code] will be converted to [code]"(1.0, 2.0, 3.0)"[/code].
+			</description>
+		</method>
 		<method name="with_dimension" qualifiers="static">
 			<return type="PackedFloat64Array" />
 			<param index="0" name="vector" type="PackedFloat64Array" />

math/basis_nd.cpp

@@ -863,7 +863,7 @@ String BasisND::to_string() {
 	const int column_count = _columns.size();
 	for (int i = 0; i < column_count; i++) {
 		const VectorN &column = _columns[i];
-		ret += String::num_int64(i) + ":" + VectorND::to_string(column);
+		ret += String::num_int64(i) + ":" + VectorND::vec_to_string(column);
 		if (i < column_count - 1) {
 			ret += ", ";
 		}

math/transform_nd.cpp

@@ -968,12 +968,12 @@ String TransformND::to_string() {
 	const int column_count = _columns.size();
 	for (int i = 0; i < column_count; i++) {
 		const VectorN &column = _columns[i];
-		ret += String::num_int64(i) + ":" + VectorND::to_string(column);
+		ret += String::num_int64(i) + ":" + VectorND::vec_to_string(column);
 		if (i < column_count - 1) {
 			ret += ", ";
 		}
 	}
-	ret += "], O" + VectorND::to_string(_origin) + ")";
+	ret += "], O" + VectorND::vec_to_string(_origin) + ")";
 	return ret;
 }
 

math/vector_nd.cpp

@@ -938,7 +938,7 @@ Vector4 VectorND::to_4d(const VectorN &p_vector) {
 	return Vector4();
 }
 
-String VectorND::to_string(const VectorN &p_vector) {
+String VectorND::vec_to_string(const VectorN &p_vector) {
 	String str = "(";
 	for (int64_t i = 0; i < p_vector.size(); i++) {
 		str += String::num(p_vector[i]);
@@ -950,10 +950,22 @@ String VectorND::to_string(const VectorN &p_vector) {
 	return str;
 }
 
-String VectorND::to_string(const Vector<VectorN> &p_vectors) {
+String VectorND::arr_to_string(const Vector<VectorN> &p_vectors) {
 	String str = "[";
 	for (int64_t i = 0; i < p_vectors.size(); i++) {
-		str += VectorND::to_string(p_vectors[i]);
+		str += VectorND::vec_to_string(p_vectors[i]);
+		if (i < p_vectors.size() - 1) {
+			str += ", ";
+		}
+	}
+	str += "]";
+	return str;
+}
+
+String VectorND::arr_to_string_bind(const TypedArray<VectorN> &p_vectors) {
+	String str = "[";
+	for (int64_t i = 0; i < p_vectors.size(); i++) {
+		str += VectorND::vec_to_string(PackedFloat64Array(p_vectors[i]));
 		if (i < p_vectors.size() - 1) {
 			str += ", ";
 		}
@@ -1031,4 +1043,6 @@ void VectorND::_bind_methods() {
 	ClassDB::bind_static_method("VectorND", D_METHOD("to_2d", "vector"), &VectorND::to_2d);
 	ClassDB::bind_static_method("VectorND", D_METHOD("to_3d", "vector"), &VectorND::to_3d);
 	ClassDB::bind_static_method("VectorND", D_METHOD("to_4d", "vector"), &VectorND::to_4d);
+	ClassDB::bind_static_method("VectorND", D_METHOD("vec_to_string", "vector"), &VectorND::vec_to_string);
+	ClassDB::bind_static_method("VectorND", D_METHOD("arr_to_string", "vectors"), &VectorND::arr_to_string_bind);
 }

math/vector_nd.h

@@ -120,8 +120,9 @@ class VectorND : public Object {
 	static Vector2 to_2d(const VectorN &p_vector);
 	static Vector3 to_3d(const VectorN &p_vector);
 	static Vector4 to_4d(const VectorN &p_vector);
-	static String to_string(const VectorN &p_vector);
-	static String to_string(const Vector<VectorN> &p_vectors);
+	static String vec_to_string(const VectorN &p_vector);
+	static String arr_to_string(const Vector<VectorN> &p_vectors);
+	static String arr_to_string_bind(const TypedArray<VectorN> &p_vectors);
 
 	static VectorND *get_singleton() { return singleton; }
 	VectorND() { singleton = this; }