Description

Use the Insert method to insert a string at a specific position within another string.

Declaration

aqString.Insert(InputString, InsertString, InsertPosition)

InputString	[in]	Required	String
InsertString	[in]	Required	String
InsertPosition	[in]	Required	Integer
Result	String

Applies To

The method is applied to the following object:

aqString

Parameters

The method has the following parameters:

InputString

The source string.

InsertString

The string to be inserted into InputString.

InsertPosition

A zero-based position of the insertion point. Possible values are 0 through the length of InputString. 0 means that InsertString will be inserted at the beginning of the InputString. The value equal to the length of InputString means that the InsertString will be appended to the end of InputString.

Result Value

A copy of the InputString string with the InsertString inserted at the specified position.

Example

The code below inserts a substring to the certain position of the specified string.

JavaScript, JScript

function InsertingSubString()
{
  var Str = "12389";
  var SubStr = "4567";
  var StartPos = 3;
  var Res = aqString.Insert( Str, SubStr, StartPos );

  Log.Message(Res); // Posts "123456789"
}

Python

def InsertingSubString():
  Str = "12389"
  SubStr = "4567"
  StartPos = 3
  Res = aqString.Insert(Str, SubStr, StartPos)
  Log.Message(Res) #Posts "123456789"

VBScript

Sub InsertingSubString

  Str = "12389"
  SubStr = "4567"
  StartPos = 3
  Res = aqString.Insert( Str, SubStr, StartPos )

  Log.Message(Res) ' Posts "123456789"

End Sub

DelphiScript

function InsertingSubString;
var Str, SubStr, StartPos, Res;
begin
  Str := '12389';
  SubStr := '4567';
  StartPos := 3;
  Res := aqString.Insert( Str, SubStr, StartPos );

  Log.Message(Res); // Posts '123456789'
end;