String.Insert(Int32, String) メソッド
定義
このインスタンス内の指定したインデックス位置に指定した文字列を挿入する場合の、新しい文字列を返します。Returns a new string in which a specified string is inserted at a specified index position in this instance.
public:
System::String ^ Insert(int startIndex, System::String ^ value);
public string Insert (int startIndex, string value);
member this.Insert : int * string -> string
Public Function Insert (startIndex As Integer, value As String) As String
パラメーター
- startIndex
- Int32
挿入の 0 から始まるインデックス位置。The zero-based index position of the insertion.
- value
- String
挿入する文字列。The string to insert.
戻り値
このインスタンスと等価で、value
の位置に startIndex
が挿入された新しい文字列。A new string that is equivalent to this instance, but with value
inserted at position startIndex
.
例外
value
が null
です。value
is null
.
startIndex
が負の数値か、またはこのインスタンスの長さを超えています。startIndex
is negative or greater than the length of this instance.
例
次の例では、文字列の4番目の文字位置 (インデックス3の文字) に空白文字を挿入します。The following example inserts a space character in the fourth character position (the character at index 3) of a string.
using System;
public class Example
{
public static void Main()
{
String original = "aaabbb";
Console.WriteLine("The original string: '{0}'", original);
String modified = original.Insert(3, " ");
Console.WriteLine("The modified string: '{0}'", modified);
}
}
// The example displays the following output:
// The original string: 'aaabbb'
// The modified string: 'aaa bbb'
Public Module Example
Public Sub Main()
Dim original As String = "aaabbb"
Console.WriteLine("The original string: '{0}'", original)
Dim modified As String = original.Insert(3, " ")
Console.WriteLine("The modified string: '{0}'", modified)
End Sub
End Module
' The example displays the following output:
' The original string: 'aaabbb'
' The modified string: 'aaa bbb'
次のコンソールアプリケーションは、2つの動物を説明するために1つ以上の形容詞を入力するようユーザーに求めます。The following console application prompts the users to enter one or more adjectives to describe two animals. 次に、メソッドを呼び出して、 Insert ユーザーが入力したテキストを文字列に挿入します。It then calls the Insert method to insert the text entered by the user into a string.
using namespace System;
int main()
{
String^ animal1 = "fox";
String^ animal2 = "dog";
String^ strTarget = String::Format( "The {0} jumps over the {1}.", animal1, animal2 );
Console::WriteLine( "The original string is:{0}{1}{0}", Environment::NewLine, strTarget );
Console::Write( "Enter an adjective (or group of adjectives) to describe the {0}: ==> ", animal1 );
String^ adj1 = Console::ReadLine();
Console::Write( "Enter an adjective (or group of adjectives) to describe the {0}: ==> ", animal2 );
String^ adj2 = Console::ReadLine();
adj1 = String::Concat( adj1->Trim(), " " );
adj2 = String::Concat( adj2->Trim(), " " );
strTarget = strTarget->Insert( strTarget->IndexOf( animal1 ), adj1 );
strTarget = strTarget->Insert( strTarget->IndexOf( animal2 ), adj2 );
Console::WriteLine( " {0}The final string is: {0} {1}", Environment::NewLine, strTarget );
}
// Output from the example might appear as follows:
// The original string is:
// The fox jumps over the dog.
//
// Enter an adjective (or group of adjectives) to describe the fox: ==> bold
// Enter an adjective (or group of adjectives) to describe the dog: ==> lazy
//
// The final string is:
// The bold fox jumps over the lazy dog.
using System;
public class Example {
public static void Main()
{
string animal1 = "fox";
string animal2 = "dog";
string strTarget = String.Format("The {0} jumps over the {1}.",
animal1, animal2);
Console.WriteLine("The original string is:{0}{1}{0}",
Environment.NewLine, strTarget);
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal1);
string adj1 = Console.ReadLine();
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal2);
string adj2 = Console.ReadLine();
adj1 = adj1.Trim() + " ";
adj2 = adj2.Trim() + " ";
strTarget = strTarget.Insert(strTarget.IndexOf(animal1), adj1);
strTarget = strTarget.Insert(strTarget.IndexOf(animal2), adj2);
Console.WriteLine("{0}The final string is:{0}{1}",
Environment.NewLine, strTarget);
}
}
// Output from the example might appear as follows:
// The original string is:
// The fox jumps over the dog.
//
// Enter an adjective (or group of adjectives) to describe the fox: ==> bold
// Enter an adjective (or group of adjectives) to describe the dog: ==> lazy
//
// The final string is:
// The bold fox jumps over the lazy dog.
Public Class Example
Public Shared Sub Main()
Dim animal1 As String = "fox"
Dim animal2 As String = "dog"
Dim strTarget As String = String.Format("The {0} jumps over the {1}.",
animal1, animal2)
Console.WriteLine("The original string is: {0}{1}{0}",
Environment.NewLine, strTarget)
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal1)
Dim adj1 As String = Console.ReadLine()
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal2)
Dim adj2 As String = Console.ReadLine()
adj1 = adj1.Trim() + " "
adj2 = adj2.Trim() + " "
strTarget = strTarget.Insert(strTarget.IndexOf(animal1), adj1)
strTarget = strTarget.Insert(strTarget.IndexOf(animal2), adj2)
Console.WriteLine("{0}The final string is:{0}{1}",
Environment.NewLine, strTarget)
End Sub
End Class
' Output from the example might appear as follows:
' The original string is:
' The fox jumps over the dog.
'
' Enter an adjective (or group of adjectives) to describe the fox: ==> bold
' Enter an adjective (or group of adjectives) to describe the dog: ==> lazy
'
' The final string is:
' The bold fox jumps over the lazy dog.
注釈
startIndex
がこのインスタンスの長さと等しい場合は、 value
がこのインスタンスの末尾に追加されます。If startIndex
is equal to the length of this instance, value
is appended to the end of this instance.
注意
このメソッドは、現在のインスタンスの値を変更しません。This method does not modify the value of the current instance. 代わりに、 value
現在のインスタンスにが挿入される新しい文字列を返します。Instead, it returns a new string in which value
is inserted into the current instance.
たとえば、の戻り値 "abc".Insert(2, "XYZ")
は "abXYZc" です。For example, the return value of "abc".Insert(2, "XYZ")
is "abXYZc".