Partager via


multimap::emplace_hint

Insère un élément construit en place (aucune opération de copie ou de mouvements n'est exécutée), avec un indicateur de positionnement.

template<class... Args>
   iterator emplace_hint(
      const_iterator where,
      Args&&... args);

Paramètres

Paramètre

Description

args

Les arguments transférés pour construire un élément à insérer dans le mappage multiple.

where

Emplacement pour commencer la recherche du point d'insertion correct. (Si ce point précède immédiatement where, l'insertion peut se produire dans le temps fixe amorti au lieu du temps logarithmique.)

Valeur de retour

Un itérateur pour l'élément récemment inséré.

Notes

Aucune référence aux éléments conteneurs n'est invalidée par cette fonction, mais elle peut invalider tous les itérateurs du conteneur.

Pendant la mise en place, si une exception est levée, l'état du conteneur n'est pas modifié.

La value_type d'un élément consiste des paires, afin que la valeur d'un élément soit une paire classée avec comme premier composant la valeur de clé et le second composant égal à la valeur de l'élément.

Pour obtenir un exemple de code, consultez map::emplace_hint.

Configuration requise

En-tête : <mappage>

Espace de noms : std

Voir aussi

Référence

<map>

multimap, classe

Bibliothèque STL (Standard Template Library)