Immediately following the end of the list is set to null. The array has more elements than the list), the element in the array If the list fits in the specified array with room to spare (i.e., Otherwise, a newĪrray is allocated with the runtime type of the specified array and In the specified array, it is returned therein. The returned array is that of the specified array. Proper sequence (from first to last element) the runtime type of Returns an array containing all of the elements in this list in Such exceptions are marked as 'optional' in the specification for this The insertion of an ineligible element into the list may throw anĮxception or it may succeed, at the option of the implementation. Operation on an ineligible element whose completion would not result in Or it may simply return false some implementations will exhibit the formerīehavior and some will exhibit the latter. To query the presence of an ineligible element may throw an exception, NullPointerException or ClassCastException. Attempting toĪdd an ineligible element throws an unchecked exception, typically For example, some implementations prohibit null elements,Īnd some have restrictions on the types of their elements. Some list implementations have restrictions on the elements that Methods are no longer well defined on such a list. Note: While it is permissible for lists to contain themselves as elements,Įxtreme caution is advised: the equals and hashCode Remove multiple elements at an arbitrary point in the list. The List interface provides two methods to efficiently insert and In many implementations they will perform costly linear From a performance standpoint, these methods should be used withĬaution. The List interface provides two methods to search for a specified

List iterator that starts at a specified position in the list. ListIterator, that allows element insertion and replacement, andīidirectional access in addition to the normal operations that the The List interface provides a special iterator, called a Preferable to indexing through it if the caller does not know the Thus, iterating over the elements in a list is typically That these operations may execute in time proportional to the index valueįor some implementations (the LinkedList class, forĮxample). The List interface provides four methods for positional (indexed)Īccess to list elements. Declarations for other inherited methods are Specified in the Collection interface, on the contracts of the The List interface places additional stipulations, beyond those Throwing runtime exceptions when the user attempts to insert them, but we That someone might wish to implement a list that prohibits duplicates, by Null elements if they allow null elements at all. Such that e1.equals(e2), and they typically allow multiple Lists typically allow pairs of elements e1 and e2 Unlike sets, lists typically allow duplicate elements. The list), and search for elements in the list. The user can access elements by their integer index (position in Interface has precise control over where in the list each element is An ordered collection (also known as a sequence).

Python add to list