C# | Array.Clear() Method

This method is used to set a range of elements in an array to the default value of each element type.

Syntax:

public static void Clear (Array array, int index, int length);

Parameters:



array: It is an array whose elements need to be cleared.
index: It is the starting index of the range of elements to clear.
length: It is the number of elements to clear.

Exceptions:

  • ArgumentNullException: if array is null
  • IndexOutOfRangeException: if the index is less than the lower bound of the array or the length is less than zero or the sum of index and length is greater than the size of the array.

Below are the examples to illustrate the Array.Clear() Method:

Example 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate Array.Clear()
// method for int type value
using System;
using System.Collections.Generic;
  
public class GFG {
  
    // Main Method
    public static void Main()
    {
  
        // Creating and intializing new the String
        int[] myArr = {10, 20, 30, 40};
  
        // Display the values of the myArr.
        Console.WriteLine("Array Before Operation:");
  
        // calling the PrintIndexAndValues() method 
        PrintIndexAndValues(myArr);
        Console.WriteLine();
  
        Array.Clear(myArr, 1, 2);
  
        // Display the values of myArr
        Console.WriteLine("Array After Operation:");
  
        // calling the PrintIndexAndValues() method
        PrintIndexAndValues(myArr);
    }
  
    // Defining the method PrintIndexAndValues 
    public static void PrintIndexAndValues(int[] myArr)
    {
        for (int i = 0; i < myArr.Length; i++) {
            Console.WriteLine("{0}", myArr[i]);
        }
    }
}

chevron_right


Output:

Array Before Operation:
10
20
30
40

Array After Operation:
10
0
0
40

Example 2: For ArgumentNullException

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate
// Array.Clear() method
// for ArgumentNullException
using System;
using System.Collections.Generic;
  
public class GFG {
  
    public static void Main()
    {
  
        try {
  
            // Creating and initializing 
            // new the Int with null
            int[] myArr = null;
  
            // Clearing the myArr
            // using Clear() method
            Console.WriteLine("Try to clear the element from null Array:");
            Array.Clear(myArr, 1, 2);
  
            // Display the values of myArr
            Console.WriteLine("Array after operation :");
  
            // calling the PrintIndexAndValues() method 
            PrintIndexAndValues(myArr);
        }
        catch (ArgumentNullException e) {
  
            Console.WriteLine();
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
        catch (IndexOutOfRangeException e) {
  
            Console.WriteLine();
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
  
    // Defining the method PrintIndexAndValues 
    public static void PrintIndexAndValues(int[] myArr)
    {
        for (int i = 0; i < myArr.Length; i++) {
            Console.WriteLine("{0}", myArr[i]);
        }
    }
}

chevron_right


Output:

Try to clear the element from null Array:

Exception Thrown: System.ArgumentNullException

Example 3: For IndexOutOfRangeException

filter_none

edit
close

play_arrow

link
brightness_4
code

// C# program to demonstrate
// Array.Clear() method
// for IndexOutOfRangeException
using System;
using System.Collections.Generic;
  
public class GFG {
  
    // Main Method
    public static void Main()
    {
  
        try {
  
            // Creating and intializing new Int array
            int[] myArr = {10, 20, 30, 40};
  
            // Display the values of myArr
            Console.WriteLine("Array Before Operation:");
  
            // calling the PrintIndexAndValues() method
            PrintIndexAndValues(myArr);
            Console.WriteLine();
  
            // Clearing the myArr
            // using Clear() method
            Console.WriteLine("Taking index out of bound:");
            Array.Clear(myArr, -1, 2);
  
            // Display the values of myArr
            Console.WriteLine("Array After Operation:");
  
            // calling the PrintIndexAndValues() method 
            PrintIndexAndValues(myArr);
        }
        catch (ArgumentNullException e) {
  
            Console.Write("Exception Thrown :");
            Console.Write("{0}", e.GetType(), e.Message);
        }
        catch (IndexOutOfRangeException e) {
            Console.Write("Exception Thrown :");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
  
    // Defining the method PrintIndexAndValues 
    public static void PrintIndexAndValues(int[] myArr)
    {
        for (int i = 0; i < myArr.Length; i++) {
            Console.WriteLine("{0}", myArr[i]);
        }
    }
}

chevron_right


Output:

Array Before Operation:
10
20
30
40

Taking index out of bound:
Exception Thrown :System.IndexOutOfRangeException

Reference:



My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :

Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.