Mercurial > hgrepos > Python2 > PyMuPDF
comparison mupdf-source/thirdparty/leptonica/src/list.h @ 2:b50eed0cc0ef upstream
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4.
The directory name has changed: no version number in the expanded directory now.
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Mon, 15 Sep 2025 11:43:07 +0200 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 1:1d09e1dec1d9 | 2:b50eed0cc0ef |
|---|---|
| 1 /*====================================================================* | |
| 2 - Copyright (C) 2001 Leptonica. All rights reserved. | |
| 3 - | |
| 4 - Redistribution and use in source and binary forms, with or without | |
| 5 - modification, are permitted provided that the following conditions | |
| 6 - are met: | |
| 7 - 1. Redistributions of source code must retain the above copyright | |
| 8 - notice, this list of conditions and the following disclaimer. | |
| 9 - 2. Redistributions in binary form must reproduce the above | |
| 10 - copyright notice, this list of conditions and the following | |
| 11 - disclaimer in the documentation and/or other materials | |
| 12 - provided with the distribution. | |
| 13 - | |
| 14 - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
| 15 - ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
| 16 - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
| 17 - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANY | |
| 18 - CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, | |
| 19 - EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, | |
| 20 - PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR | |
| 21 - PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY | |
| 22 - OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING | |
| 23 - NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 - SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 *====================================================================*/ | |
| 26 | |
| 27 | |
| 28 #ifndef LEPTONICA_LIST_H | |
| 29 #define LEPTONICA_LIST_H | |
| 30 | |
| 31 /*! | |
| 32 * \file list.h | |
| 33 * | |
| 34 * <pre> | |
| 35 * Cell for double-linked lists | |
| 36 * | |
| 37 * This allows composition of a list of cells with | |
| 38 * prev, next and data pointers. Generic data | |
| 39 * structures hang on the list cell data pointers. | |
| 40 * | |
| 41 * The list is not circular because that would add much | |
| 42 * complexity in traversing the list under general | |
| 43 * conditions where list cells can be added and removed. | |
| 44 * The only disadvantage of not having the head point to | |
| 45 * the last cell is that the list must be traversed to | |
| 46 * find its tail. However, this traversal is fast, and | |
| 47 * the listRemoveFromTail() function updates the tail | |
| 48 * so there is no searching overhead with repeated use. | |
| 49 * | |
| 50 * The list macros are used to run through a list, and their | |
| 51 * use is encouraged. They are invoked, e.g., as | |
| 52 * | |
| 53 * DLLIST *head, *elem; | |
| 54 * ... | |
| 55 * L_BEGIN_LIST_FORWARD(head, elem) | |
| 56 * <do something with elem and/or elem->data > | |
| 57 * L_END_LIST | |
| 58 * </pre> | |
| 59 */ | |
| 60 | |
| 61 struct DoubleLinkedList | |
| 62 { | |
| 63 struct DoubleLinkedList *prev; | |
| 64 struct DoubleLinkedList *next; | |
| 65 void *data; | |
| 66 }; | |
| 67 typedef struct DoubleLinkedList DLLIST; | |
| 68 | |
| 69 | |
| 70 /*! Simple list traverse macro - forward */ | |
| 71 #define L_BEGIN_LIST_FORWARD(head, element) \ | |
| 72 { \ | |
| 73 DLLIST *_leptvar_nextelem_; \ | |
| 74 for ((element) = (head); (element); (element) = _leptvar_nextelem_) { \ | |
| 75 _leptvar_nextelem_ = (element)->next; | |
| 76 | |
| 77 | |
| 78 /*! Simple list traverse macro - reverse */ | |
| 79 #define L_BEGIN_LIST_REVERSE(tail, element) \ | |
| 80 { \ | |
| 81 DLLIST *_leptvar_prevelem_; \ | |
| 82 for ((element) = (tail); (element); (element) = _leptvar_prevelem_) { \ | |
| 83 _leptvar_prevelem_ = (element)->prev; | |
| 84 | |
| 85 | |
| 86 /*! Simple list traverse macro - end of a list traverse */ | |
| 87 #define L_END_LIST }} | |
| 88 | |
| 89 | |
| 90 #endif /* LEPTONICA_LIST_H */ |
