bsl::list::erase

Remove from this list the elements starting at the specified dstBegin position up to, but not including, the specified dstEnd position, and return a non‐`const` iterator equivalent to dstEnd. The behavior is undefined unless dstBegin is an iterator in the range [begin() .. end()] and dstEnd is an iterator in the range [dstBegin .. end()] (both endpoints included). Note that dstBegin may be equal to dstEnd, in which case the list is not modified.