tags:

views:

139

answers:

4

Hi,

In the .NET framework, many of the System.Collection classes have Clear methods on them. Is there a clear advantage on using this versus replacing the reference with a new object?

Thanks.

+12  A: 

You'd want to use Clear if you have other references to the same object, and you want to keep them all pointing to the same object.

For example maybe you have a worker queue where you store tasks to do. And in one or more threads you take work items out of this queue (of course you use locking to make sure you access the queue with at most one thread at a time). If at some point you want to empty the queue, then you can use Clear and all threads will still point to the same object.

As seen here when you use Clear all items will be removed, and the Count will be 0, but the Capacity will remain unchanged. Usually the Capacity being unchanged is a good thing (for efficiency), but there could be some extreme case that you had a ton of items and you want that memory to be eventually freed.

The MSDN link above also mentions that Clear is an O(n) operation. Whereas simply replacing the reference will be an O(1) operation and then eventually it will be garbage collected but possibly not right away. But replacing the reference also means that the memory that makes up the capacity will need to be re-allocated.

Brian R. Bondy
This got most of it, the only thing I want to add is that you want to use Clear when dealing with ObservableCollections that are being watched already.
Rangoric
+1  A: 

replacing the reference will not release the collection right away it will need to wait for garbage collector to dispose the object,

if you want to reutilize the same object collection the use clear if not you will have the two objects in memory for some time.

Oscar Cabrero
Although this is true, this is not the difference that most people care about.
Ignacio Vazquez-Abrams
+2  A: 

Brian is correct but to be more specific, the Clear method removes all items from the current instance of the collection. Instantiating a new collection and assigning its reference to your variable will give you an entirely new instance altogether and may cause some unintended consequences depending on whether or not other people are holding a reference to the old instance. If another thread has a reference to that collection they will still hold a reference to the old collection even though you have created a new instance.

Andrew Hare
+2  A: 

That would depends maybe on how large your collection object is. I think when you say new it will create the original size of the object, clear would just clear the content but the size would still be the same.

hallie