System.UnicodeString.Insert

De RAD Studio API Documentation
Aller à : navigation, rechercher

C++

UnicodeString& Insert(const UnicodeString& str, int index) _ALWAYS_INLINE {

Propriétés

Type Visibilité  Source Unité  Parent
function public ustring.h System UnicodeString

Description

Insère une chaîne spécifiée dans UnicodeString.

Insert insère la chaîne str dans cet objet UnicodeString en commençant à la position index, où 1 représente la première position dans la chaîne. Elle renvoie la chaîne résultante modifiée (*this).

Si index est inférieur à 1, il est mappé sur 1. S'il dépasse la fin de la chaîne, il est défini sur Length, en transformant l'opération en ajout.

Si le paramètre str est une chaîne vide, Insert ne fait rien.

Insert déclenche une exception EOutOfMemory si la méthode ne peut pas allouer suffisamment de mémoire pour accepter la nouvelle chaîne plus longue.

Remarque :  Le paramètre index spécifie toujours l'indice du caractère (pas de l'octet).

Voir aussi