ArrayList::Repeat Method (Object^, Int32)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Returns an ArrayList whose elements are copies of the specified value.

Namespace:   System.Collections
Assembly:  mscorlib (in mscorlib.dll)

public:
static ArrayList^ Repeat(
	Object^ value,
	int count
)

Parameters

value
Type: System::Object^

The Object to copy multiple times in the new ArrayList. The value can be null.

count
Type: System::Int32

The number of times value should be copied.

Return Value

Type: System.Collections::ArrayList^

An ArrayList with count number of elements, all of which are copies of value.

Exception Condition
ArgumentOutOfRangeException

count is less than zero.

ArrayList accepts null as a valid value and allows duplicate elements.

This method is an O(n) operation, where n is count.

The following code example shows how to create and initialize a new ArrayList with the same value.

using namespace System;
using namespace System::Collections;
void PrintValues( IEnumerable^ myList );
int main()
{

   // Creates a new ArrayList with five elements and initialize each element with a null value.
   ArrayList^ myAL = ArrayList::Repeat( 0, 5 );

   // Displays the count, capacity and values of the ArrayList.
   Console::WriteLine( "ArrayList with five elements with a null value" );
   Console::WriteLine( "   Count    : {0}", myAL->Count );
   Console::WriteLine( "   Capacity : {0}", myAL->Capacity );
   Console::Write( "   Values:" );
   PrintValues( myAL );

   // Creates a new ArrayList with seven elements and initialize each element with the string "abc".
   myAL = ArrayList::Repeat( "abc", 7 );

   // Displays the count, capacity and values of the ArrayList.
   Console::WriteLine( "ArrayList with seven elements with a string value" );
   Console::WriteLine( "   Count    : {0}", myAL->Count );
   Console::WriteLine( "   Capacity : {0}", myAL->Capacity );
   Console::Write( "   Values:" );
   PrintValues( myAL );
}

void PrintValues( IEnumerable^ myList )
{
   IEnumerator^ myEnum = myList->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ obj = safe_cast<Object^>(myEnum->Current);
      Console::Write( "   {0}", obj );
   }

   Console::WriteLine();
}

/* 
 This code produces the following output.

 ArrayList with five elements with a null value
    Count    : 5
    Capacity : 16
    Values:
 ArrayList with seven elements with a string value
    Count    : 7
    Capacity : 16
    Values:   abc   abc   abc   abc   abc   abc   abc

 */

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Return to top
Show: