std::forward_list::begin
#include <forward_list>
iterator begin() noexcept;
const_iterator begin() const noexcept;
Trả về một iterator trỏ đến phần tử đầu tiên 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 phần tử đầu tiên trong forward_list.
- const_iterator (phiên bản const): Trả về một iterator chỉ đọc, trỏ đến phần tử đầu tiên 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
- Trỏ đến phần tử đầu tiên:
begin()
luôn trả về iterator trỏ đến phần tử đầu tiên trong forward_list. - Có thể dereference: Không giống như
before_begin()
, bạn có thể dereference (sử dụng toán tử*
) iterator trả về bởibegin()
để truy cập giá trị của phần tử đầu tiên. - noexcept: Cả hai phiên bản của
begin()
đề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 before_begin():
begin()
trỏ đến phần tử đầu tiên, trong khibefore_begin()
trỏ đến vị trí trước phần tử đầu tiên. - Phân biệt với
end()
:begin()
trỏ đến phần tử đầu tiên, trong khiend()
trỏ đến vị trí sau phần tử cuối cùng (past-the-end). - Không làm thay đổi danh sách: Gọi
begin()
không làm thay đổi nội dung hay trạng thái của forward_list. - forward_list rỗng: Nếu forward_list rỗng thì
begin()
sẽ trả về giá trị giốngend()
. - Độ 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
cbegin | Trả về một const_iterator trỏ đến phần tử đầu tiên trong forward_list |
front | Trả về tham chiếu đến phần tử đầu tiên trong forward_list |
end | Trả về một iterator trỏ đến vị trí sau phần tử cuối cùng trong forward_list |
before_begin | Trả về một iterator trỏ đến vị trí trước phần tử đầu tiên trong forward_list |