comparison mupdf-source/thirdparty/leptonica/src/stack.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 #ifndef LEPTONICA_STACK_H
28 #define LEPTONICA_STACK_H
29
30 /*!
31 * \file stack.h
32 *
33 * <pre>
34 * Expandable pointer stack for arbitrary void* data.
35 *
36 * The L_Stack is an array of void * ptrs, onto which arbitrary
37 * objects can be stored. At any time, the number of
38 * stored objects is stack->n. The object at the bottom
39 * of the stack is at array[0]; the object at the top of
40 * the stack is at array[n-1]. New objects are added
41 * to the top of the stack, at the first available location,
42 * which is array[n]. Objects are removed from the top of the
43 * stack. When an attempt is made to remove an object from an
44 * empty stack, the result is null. When the stack becomes
45 * filled, so that n = nalloc, the size is doubled.
46 *
47 * The auxiliary stack can be used to store and remove
48 * objects for re-use. It must be created by a separate
49 * call to pstackCreate(). [Just imagine the chaos if
50 * pstackCreate() created the auxiliary stack!]
51 * pstackDestroy() checks for the auxiliary stack and removes it.
52 * </pre>
53 */
54
55
56 /*! Expandable pointer stack for arbitrary void* data.
57 * Note that array[n] is the first null ptr in the array
58 */
59 struct L_Stack
60 {
61 l_int32 nalloc; /*!< size of ptr array */
62 l_int32 n; /*!< number of stored elements */
63 void **array; /*!< ptr array */
64 struct L_Stack *auxstack; /*!< auxiliary stack */
65 };
66 typedef struct L_Stack L_STACK;
67
68
69 #endif /* LEPTONICA_STACK_H */
70