containers doc brush
This commit is contained in:
@@ -1193,7 +1193,7 @@ public:
|
||||
//! \~\code
|
||||
//! PIDeque<int> v{2, 5, 9, 2};
|
||||
//! int a[2] = {12, 13};
|
||||
//! memcpy(vec.data(1), carr, 2 * sizeof(int));
|
||||
//! memcpy(vec.data(1), a, 2 * sizeof(int));
|
||||
//! piCout << v; // {2, 12, 13, 2}
|
||||
//! \endcode
|
||||
inline T * data(size_t index = 0) {
|
||||
@@ -1238,7 +1238,7 @@ public:
|
||||
//! \~russian
|
||||
//! Индекс начала должен лежать в диапазоне от `0` до `size()-1`.
|
||||
//! Если заданный размер подмассива превышает размер текущего массива,
|
||||
//! то вернется подмассив меншего размера (`size()-index-1`).
|
||||
//! то вернется подмассив меньшего размера (`size()-index-1`).
|
||||
PIDeque<T> getRange(size_t index, size_t count) const {
|
||||
if (index >= pid_size || count == 0) return PIDeque<T>();
|
||||
if (index + count > pid_size) count = pid_size - index;
|
||||
@@ -1249,8 +1249,9 @@ public:
|
||||
//! \~english Clear array, remove all elements.
|
||||
//! \~russian Очищает массив, удаляет все элементы.
|
||||
//! \~\details
|
||||
//! \~english Note: reserved memory will not be released.
|
||||
//! \~russian Замечание: зарезервированная память не освободится.
|
||||
//! \~\note
|
||||
//! \~english Reserved memory will not be released.
|
||||
//! \~russian Зарезервированная память не освободится.
|
||||
//! \~\sa \a resize()
|
||||
template<typename T1 = T, typename std::enable_if<
|
||||
!std::is_trivially_copyable<T1>::value
|
||||
@@ -1317,7 +1318,7 @@ public:
|
||||
|
||||
//! \~\brief
|
||||
//! \~english First does `resize(new_size)` then `fill(e)`.
|
||||
//! \~russian Сначала делает `resize(new_size)` затем `fill(e)`.
|
||||
//! \~russian Сначала делает `resize(new_size)`, затем `fill(e)`.
|
||||
//! \~\sa \a fill(), \a resize()
|
||||
template<typename T1 = T, typename std::enable_if<
|
||||
!std::is_trivially_copyable<T1>::value
|
||||
@@ -1559,7 +1560,7 @@ public:
|
||||
|
||||
//! \~\brief
|
||||
//! \~english Removes `count` elements from the middle of the array, starting at `index` position.
|
||||
//! \~russian Удаляет элементы из массива, начиная с позиции `index`, в количестве `count`.
|
||||
//! \~russian Удаляет элементы из массива, начиная с позиции `index` в количестве `count`.
|
||||
//! \~\details
|
||||
//! \code
|
||||
//! PIDeque<int> v{1, 3, 7, 5};
|
||||
@@ -1711,8 +1712,8 @@ public:
|
||||
//! \~english If `add_size > 0` then elements are added to the end of the array.
|
||||
//! If `add_size < 0` then elements are removed from the end of the array.
|
||||
//! If `add_size < 0` and there are fewer elements in the array than specified, then the array becomes empty.
|
||||
//! \~russian Если `add_size > 0` то в конец массива добавляются элементы.
|
||||
//! Если `add_size < 0` то с конца массива удаляются элементы.
|
||||
//! \~russian Если `add_size > 0`, то в конец массива добавляются элементы.
|
||||
//! Если `add_size < 0`, то с конца массива удаляются элементы.
|
||||
//! Если `add_size < 0` и в массиве меньше элементов чем указано, то массив становится пустым.
|
||||
//! \~\sa \a resize()
|
||||
inline PIDeque<T> & enlarge(llong pid_size) {
|
||||
@@ -1795,12 +1796,12 @@ public:
|
||||
//! then all iterators and references
|
||||
//! (including the past-the-end iterator) are invalidated.
|
||||
//! Otherwise only the past-the-end iterator is invalidated.
|
||||
//! \~russian Если size() меньше capacity(), что чаше всего,
|
||||
//! \~russian Если size() меньше capacity(), что часто бывает,
|
||||
//! то добавление будет очень быстрым.
|
||||
//! В любом случае добавление быстрое и не зависит от размера массива.
|
||||
//! Если новый size() больше, чем capacity(),
|
||||
//! то все итераторы и указатели становятся нерабочими.
|
||||
//! В противном случае, все, кроме итераторов указывающих на конец массива,
|
||||
//! В противном случае все, кроме итераторов, указывающих на конец массива,
|
||||
//! остаются в рабочем состоянии.
|
||||
//! \~\code
|
||||
//! PIDeque<int> v{1, 2, 3};
|
||||
@@ -1879,12 +1880,12 @@ public:
|
||||
//! then all iterators and references
|
||||
//! (including the past-the-end iterator) are invalidated.
|
||||
//! Otherwise only the past-the-end iterator is invalidated.
|
||||
//! \~russian Если size() меньше capacity(), что чаше всего,
|
||||
//! \~russian Если size() меньше capacity(), что часто бывает,
|
||||
//! то добавление будет очень быстрым.
|
||||
//! В любом случае добавление быстрое и не зависит от размера массива.
|
||||
//! Если новый size() больше, чем capacity(),
|
||||
//! то все итераторы и указатели становятся нерабочими.
|
||||
//! В противном случае, все, кроме итераторов указывающих на конец массива,
|
||||
//! В противном случае все, кроме итераторов, указывающих на конец массива,
|
||||
//! остаются в рабочем состоянии.
|
||||
//! \~\code
|
||||
//! PIDeque<int> v{1, 2, 3};
|
||||
@@ -1993,11 +1994,11 @@ public:
|
||||
//! (including the past-the-begin iterator) are invalidated.
|
||||
//! Otherwise only the past-the-begin iterator is invalidated.
|
||||
//! \~russian Если в начале массива имеется свободное место,
|
||||
//! что чаше всего, то добавление будет очень быстрым.
|
||||
//! что часто бывает, то добавление будет очень быстрым.
|
||||
//! В любом случае добавление быстрое и не зависит от размера массива.
|
||||
//! Если в начале массива нет свободного места,
|
||||
//! то все итераторы и указатели становятся нерабочими.
|
||||
//! В противном случае, все, кроме итераторов указывающих на начало массива,
|
||||
//! В противном случае все, кроме итераторов указывающих, на начало массива,
|
||||
//! остаются в рабочем состоянии.
|
||||
//! \~\code
|
||||
//! PIDeque<int> v{1, 2, 3};
|
||||
@@ -2068,11 +2069,11 @@ public:
|
||||
//! (including the past-the-begin iterator) are invalidated.
|
||||
//! Otherwise only the past-the-begin iterator is invalidated.
|
||||
//! \~russian Если в начале массива имеется свободное место,
|
||||
//! что чаше всего, то добавление будет очень быстрым.
|
||||
//! что часто бывает, то добавление будет очень быстрым.
|
||||
//! В любом случае добавление быстрое и не зависит от размера массива.
|
||||
//! Если в начале массива нет свободного места,
|
||||
//! то все итераторы и указатели становятся нерабочими.
|
||||
//! В противном случае, все, кроме итераторов указывающих на начало массива,
|
||||
//! В противном случае все, кроме итераторов указывающих, на начало массива,
|
||||
//! остаются в рабочем состоянии.
|
||||
//! \~\code
|
||||
//! PIDeque<int> v{1, 2, 3};
|
||||
@@ -2154,7 +2155,7 @@ public:
|
||||
//! \~english Removing an element from the beginning takes longer than from the end.
|
||||
//! This time is directly proportional to the size of the array.
|
||||
//! All iterators and references are invalidated.
|
||||
//! \~russian Удаление элемента с начала выполняется дольше чем с конца.
|
||||
//! \~russian Удаление элемента с начала выполняется дольше, чем с конца.
|
||||
//! Это время прямопропорционально размеру массива.
|
||||
//! При удалении элемента все итераторы и указатели становятся нерабочими.
|
||||
//! \~\code
|
||||
@@ -2292,7 +2293,7 @@ public:
|
||||
//! once for each element in an array, in order,
|
||||
//! and constructs a new array from the results.
|
||||
//! \~russian Метод `map` вызывает переданную функцию `ST f(const T & e)`
|
||||
//! один раз для каждого элемента, в порядке их появления
|
||||
//! один раз для каждого элемента в порядке их появления
|
||||
//! и конструирует новый массив из результатов её вызова.
|
||||
//! \~\code
|
||||
//! PIDeque<int> v{1, 2, 3};
|
||||
@@ -2411,7 +2412,7 @@ public:
|
||||
//! \~russian Изменяет размерность массива, из двухмерный массива создает одномерный.
|
||||
//! \~\details
|
||||
//! \~russian Делает массив плоским.
|
||||
//! Порядок обхода исходного массива, задаётся с помощью \a ReshapeOrder.
|
||||
//! Порядок обхода исходного массива задаётся с помощью \a ReshapeOrder.
|
||||
//! \~english Makes the array flat.
|
||||
//! Еhe order of traversing the source array is set using \a ReshapeOrder.
|
||||
//! \~\code
|
||||
|
||||
Reference in New Issue
Block a user