99 |
99 |
100 /** |
100 /** |
101 * Copies elements from one array to another. |
101 * Copies elements from one array to another. |
102 * |
102 * |
103 * The elements are copied to the \p target array at the specified \p index, |
103 * The elements are copied to the \p target array at the specified \p index, |
104 * overwriting possible elements. The index must be in range of the current |
104 * overwriting possible elements. The \p index does not need to be in range of |
105 * array \p size. If the number of elements added would extend the array's size, |
105 * the current array \p size. If the new index plus the number of elements added |
106 * and \p capacity is not \c NULL, the remaining capacity is used. |
106 * would extend the array's size, and \p capacity is not \c NULL, the remaining |
|
107 * capacity is used. |
107 * |
108 * |
108 * If the capacity is insufficient to hold the new data, a reallocation |
109 * If the capacity is insufficient to hold the new data, a reallocation |
109 * attempt is made, unless the allocator is set to \c NULL, in which case |
110 * attempt is made, unless the allocator is set to \c NULL, in which case |
110 * this function ultimately returns a failure. |
111 * this function ultimately returns a failure. |
111 * |
112 * |