Как использовать список из sys / queue.h? - PullRequest
Новая
       13

Как использовать список из sys / queue.h?

24 голосов
/ 02 октября 2011

В настоящее время я реализовал односвязный список, например: 

struct PeerNode {
     struct Peer* cargo;
     struct PeerNode* next;
};

... и у меня есть структура, которая содержит пару этих связанных списков, например: 

struct Torrent {
     ...
     struct PeerNode* peer_list;
     struct PeerNode* unchoked_peers;
     ...
}

Я хотел бы заменить это с помощью макросов, предоставленных sys/queue.h. Я понял, что могу заменить свой код на что-то вроде этого: 

struct Torrent {
     ...
     LIST_ENTRY(PeerNode, Peer) peer_list;
     struct PeerNode* unchoked_peers;
     ...
}

Затем, глядя на man queue, я полагаю, что инициализировал бы списки, выполнив что-то вроде этого: 

LIST_INIT(&peer_list);
LIST_INIT(unchoked_peers);

Однако я не понимаю, как LIST_ENTRY влияет на использование списка. На странице man написано: «Макрос LIST_ENTRY объявляет структуру, которая связывает элементы в списке», но я не совсем понимаю, что это значит.

Зачем мне объявлять структуру для соединения элементов в списке? Разве каждый узел не должен быть связан со следующим узлом через указатель, как моя первоначальная реализация связанного списка? Как бы я заменил мои связанные списки реализацией, предоставленной sys/queue.h? Как мне вставить элемент в список?

1 Ответ

33 голосов
/ 02 октября 2011

LIST_ENTRY создает поля для размещения в вашей структуре, которые подходят для связывания элементов, поэтому вам не нужно заботиться о специфике этих указателей. 

struct foo {
    int a, b, c;
    /* This is instead of "struct foo *next" */
    LIST_ENTRY(foo) pointers;
};

Чтобы затем создать список, который вы 'd использовать LIST_HEAD (): 

struct Torrent {
    LIST_HEAD(foo_list, foo) bar;
};

Вы можете инициализировать заголовок списка, используя LIST_INIT (): 

struct Torrent t;
LIST_INIT(&t.bar);

Вы можете вставлять элементы, используя макросы LIST_INSERT _ * (): 

struct foo *item = malloc(sizeof(struct foo));
LIST_INSERT_HEAD(&t.bar, item, pointers);

Все это было взято из списка примеров на страницах руководства по адресу http://www.manpagez.com/man/3/queue/

...