Inserts the specified element into this queue if it is possible to do
so immediately without violating capacity restrictions.
When using a capacity-restricted queue, this method is generally
preferable to {@link #add}, which can fail to insert an element only
by throwing an exception.
@param e the element to add
@return {@code true} if the element was added to this queue, else
{@code false}
@throws ClassCastException if the class of the specified element
prevents it from being added to this queue
@throws NullPointerException if the specified element is null and
this queue does not permit null elements
@throws IllegalArgumentException if some property of this element
prevents it from being added to this queue
Inserts the specified element into this queue if it is possible to do so immediately without violating capacity restrictions. When using a capacity-restricted queue, this method is generally preferable to {@link #add}, which can fail to insert an element only by throwing an exception.
@param e the element to add @return {@code true} if the element was added to this queue, else {@code false} @throws ClassCastException if the class of the specified element prevents it from being added to this queue @throws NullPointerException if the specified element is null and this queue does not permit null elements @throws IllegalArgumentException if some property of this element prevents it from being added to this queue