What should I use as return type of method IEnumerable, IList, Collection or what

Question

I am making a library which is going to be used widely by different applications. You can say that it is sort of a public library or SDK.

Currently I am working on a function which takes a list of Points performs some calculation on these points and then return list of updated points. So my question here is what should I use as return type and in my parameters. IList, IEnumerable or Collection.

So here it the function. I am unaware what user will do with the output. How user uses it, is on him. So what should be best option to use here.

public static IEnumerable<Point2D> PeformSomeCalculation(IEnumerable<Point2D> points)
{
    // Do something,
    return updatedPoints;
}

Answer 1

The IList<T> interface inherits from ICollection<T>, IEnumerable<T> and IEnumerable.

So if you return an IList<T>, clients that want an ICollection<T>, an IEnumerable<T> or just an IEnumerable will all be happy.

Answer 2

Do you want the points collection to be manipulated?

If so use ICollection or an IList as these expose Add, Clear and Remove methods.

If you need the list to be indexed then you should choose IList - this interface inherits from ICollection and IEnumerable so this may be what you are after.

If you do not require the collection to be modified or indexed then use IEnumerable.