Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::move_backward — přesun rozsahu od konce

std::move_backward přiřazuje prvky rozsahu od posledního k prvnímu a zachovává jejich pořadí v cíli. Umožňuje bezpečně posunout překrývající se rozsah doprava.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <algorithm>

template<class BidirectionalIterator1, class BidirectionalIterator2>
constexpr BidirectionalIterator2 move_backward(
    BidirectionalIterator1 first,
    BidirectionalIterator1 last,
    BidirectionalIterator2 result);

std::move_backward z hlavičky <algorithm> přiřazuje přesunem prvky z [first, last) do rozsahu, který končí bezprostředně před result. Pro N prvků je cílový rozsah [result - N, result). Zpracování pozpátku pořadí prvků neobrací.

Oba typy iterátorů musí být obousměrné a cílové prvky už musí existovat a podporovat přiřazení přesunem. Algoritmus kontejner nezvětšuje. Provede přesně N přiřazení a vrátí iterátor na začátek cílového rozsahu. Zápis result - N popisuje pozici; nevyžaduje iterátory s náhodným přístupem.

Pozor na překryv: result nesmí patřit do (first, last]; porušení této předpodmínky vede k nedefinovanému chování. U překrývajících se rozsahů použijte tento algoritmus k posunu doprava a tříargumentové std::move k posunu doleva. Jednoargumentové std::move je přetypování umožňující přesun, nikoli algoritmus pro rozsah.

Příklad posune tři celá čísla o dvě pozice doprava. Při přiřazení přesunem typu int se zachová hodnota zdroje, takže výsledek je deterministický. U libovolných třídních typů s tímto chováním nepočítejte.

Příklady

#include <algorithm>
#include <iostream>

int main() {
    int values[] = {1, 2, 3, 0, 0};
    auto first_moved = std::move_backward(values, values + 3, values + 5);

    std::cout << "start: " << (first_moved - values) << '\n';
    for (int i = 0; i < 5; ++i) {
        if (i != 0) std::cout << ' ';
        std::cout << values[i];
    }
    std::cout << '\n';
}

Výsledek

start: 2
1 2 1 2 3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje