Initial Commit.

2026-06-23 21:47:51 +08:00
commit d17f68e979
5201 changed files with 318318 additions and 0 deletions
@@ -0,0 +1,77 @@
+# ArrayRemove
+
+Removes the specified number of elements from the array starting with a specified index.
+
+```
+bool  ArrayRemove(
+   void&        array[],            // array of any type
+   uint         start,              // index the removal starts from
+   uint         count=WHOLE_ARRAY   // number of elements
+   );
+
+```
+
+Parameters
+
+array[]
+
+[in][out]  Array.
+
+start
+
+[in]  Index, starting from which the array elements are removed.
+
+count=WHOLE_ARRAY
+
+[in]  Number of removed elements. The [WHOLE_ARRAY](/en/docs/constants/namedconstants/otherconstants) value means removing all elements from the specified index up the end of the array.
+
+Return Value
+
+Returns true if successful, otherwise - false. To get information about the error, call the [GetLastError()](/en/docs/check/getlasterror) function. Possible errors:
+
+- 5052 – ERR_SMALL_ARRAY (too big start value),
+- 5056 – ERR_SERIES_ARRAY (the array cannot be changed, indicator buffer),
+- 4003 – ERR_INVALID_PARAMETER (too big count value),
+- 4005 - ERR_STRUCT_WITHOBJECTS_ORCLASS (fixed-size array containing complex objects with the destructor),
+- 4006 - ERR_INVALID_ARRAY  (fixed-size array containing structure or class objects with a destructor).
+
+Note
+
+If the function is used for a fixed-size array, the array size does not change: the remaining "tail" is physically copied to the start position. For accurate understanding of how the function works, see the example below. "Physical" copying means the copied objects are not created by calling the constructor or copying operator. Instead, the binary representation of an object is copied. For this reason, you cannot apply the ArrayRemove() function to the fixed-size array containing objects with the destructor (the ERR_INVALID_ARRAY or ERR_STRUCT_WITHOBJECTS_ORCLASS error is activated). When removing such an object, the destructor should be called twice – for the original object and its copy.
+
+You cannot remove elements from dynamic arrays designated as the indicator buffers by the [SetIndexBuffer()](/en/docs/customind/setindexbuffer) function. This will result in the ERR_SERIES_ARRAY error. For indicator buffers, all size changing operations are performed by the terminal's executing subsystem.
+
+Example:
+
+```
+//+------------------------------------------------------------------+
+//| Script program start function                                    |
+//+------------------------------------------------------------------+
+void OnStart()
+  {
+//--- declare the fixed-size array and fill in the values
+   int array[10];
+   for(int i=0;i<10;i++)
+     {
+      array[i]=i;
+     }
+//--- display the array before removing the elements
+   Print("Before calling ArrayRemove()");
+   ArrayPrint(array);
+//--- delete 2 elements from the array and display the new set
+   ArrayRemove(array,4,2);
+   Print("After calling ArrayRemove()");
+   ArrayPrint(array);
+/*
+  Execution result:
+  Before calling ArrayRemove()
+   0 1 2 3 4 5 6 7 8 9
+  After calling ArrayRemove()
+   0 1 2 3 6 7 8 9 8 9
+*/
+
+```
+
+See also
+
+[ArrayInsert](/en/docs/array/arrayinsert),[ ArrayCopy](/en/docs/array/arraycopy), [ArrayResize](/en/docs/array/arrayresize), [ArrayFree](/en/docs/array/arrayfree)