std::forward_list::end
#include <forward_list>
iterator end() noexcept;
const_iterator end() const noexcept;
Trả về một iterator trỏ đến vị trí sau phần tử cuối cùng trong forward_list.
Tham số
Không có tham số
Giá trị trả về
- iterator (phiên bản không const): Trả về một iterator có thể đọc và ghi, trỏ đến vị trí sau phần tử cuối cùng trong forward_list.
- const_iterator (phiên bản const): Trả về một iterator chỉ đọc, trỏ đến vị trí sau phần tử cuối cùng trong forward_list. Phiên bản này được sử dụng khi forward_list là một đối tượng
const
.
Đặc điểm
- Vị trí "past-the-end":
end()
không trỏ đến một phần tử thực sự trong forward_list, mà là một vị trí sau phần tử cuối cùng. - Không thể dereference: Bạn không thể dereference (sử dụng toán tử
*
) iterator trả về bởiend()
vì nó không trỏ đến một phần tử hợp lệ. - Đánh dấu kết thúc danh sách:
end()
được sử dụng để đánh dấu điểm kết thúc của forward_list trong các vòng lặp và thuật toán. - noexcept: Cả hai phiên bản của
end()
đều được đánh dấu lànoexcept
, nghĩa là chúng được đảm bảo không ném ra ngoại lệ nào. - Phân biệt với begin():
begin()
trỏ đến phần tử đầu tiên, trong khiend()
trỏ đến vị trí sau phần tử cuối cùng. - forward_list rỗng: Nếu forward_list rỗng thì
end()
sẽ trả về giá trị giốngbegin()
. - Không làm thay đổi danh sách: Gọi
end()
không làm thay đổi nội dung hay trạng thái của forward_list. - Độ phức tạp:
O(1)
- thời gian hằng số.
Ví dụ
#include <iostream>
#include <forward_list>
int main() {
std::forward_list<int> mylist;
if (mylist.begin() == mylist.end()) {
std::cout << "mylist is empty\n"; // Output: mylist is empty
}
return 0;
}
Các hàm liên quan
cend | Trả về một const_iterator trỏ đến vị trí sau phần tử cuối cùng trong forward_list |
begin | Trả về một iterator trỏ đến phần tử đầu tiên trong forward_list |