API:System.AnsiStringT.Insert

• Aller au parent : AnsiStringT

C++

AnsiStringT&  Insert(const AnsiStringT& str, int index) {

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	dstring.h	System	AnsiStringT

Description

Insert la chaîne spécifiée dans la AnsiStringBase.

System.AnsiStringT.Insert hérite de System.AnsiStringBase.Insert. Tout le contenu en-dessous de cette ligne se réfère à System.AnsiStringBase.Insert.

Insert la chaîne spécifiée dans la AnsiStringBase.

Insert insère la chaîne str dans cette AnsiStringBase 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 amené à 1. S'il dépasse la fin de la chaîne, il est initialisé à 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 indique le caractère, et non l'octet, lors du fonctionnement dans un système de caractère multi-octet.