This file is indexed.

/usr/include/epr_ptrarray.h is in libepr-api2-dev 2.2-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/*
 * $Id: epr_ptrarray.h,v 1.1.1.1 2004-10-28 19:22:23 norman Exp $
 *
 * Copyright (C) 2002 by Brockmann Consult (info@brockmann-consult.de)
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation. This program is distributed in the hope it will
 * be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 */

#ifndef EPR_PTRARRAY_H_INCL
#define EPR_PTRARRAY_H_INCL

#ifdef __cplusplus
extern "C" 
{
#endif

#include <stdlib.h>

/**
 * The <code>EPR_PtrArray</code> structure represents a dynamic
 * array of pointers.
 */
struct EPR_PtrArray
{
	/** The current capacity */
    unsigned int capacity;
    /** The current length */
    unsigned int length;
    /** The pointer elements */
    void** elems;
};

typedef struct EPR_PtrArray EPR_SPtrArray;

/**
 * Creates a new dynamic pointer array instance.
 *
 * @param capacity the initial capacity
 * @return a new dynamic pointer array instance with the given capacity or
 *        <code>NULL</code> if memory could not be allocated
 */
EPR_SPtrArray* epr_create_ptr_array(unsigned int capacity);


/**
 * Frees the memory allocated through the given dynamic pointer array.
 *
 * <p> After calling this function the give record pointer array gets
 * invalid and should not be used anymore.
 * 
 * @param ptr_array the pointer array to be released, if <code>NULL</code>
 *        the function immediately returns
 */
void epr_free_ptr_array(EPR_SPtrArray* ptr_array);


/**
 * Special application of the <code>epr_free_ptr_array</code> for
 * arrays that contain dynamically allocated strings (type <code>char*</code>).
 *
 * <p>For each element in the given array the <code>epr_free_string</code> 
 * function is called.
 *
 * @param char_ptr_array an array containing strings
 */
void epr_free_char_ptr_array(EPR_SPtrArray* char_ptr_array);

/**
 * Adds a new pointer to the given pointer array.
 * The function automatically grows the array if necessary.
 *
 * @param ptr_array the pointer array to which to add the new element,
 *        must not be NULL.
 * @param elem the element to be added
 * @return zero for success, an error code otherwise
 */
int epr_add_ptr_array_elem(EPR_SPtrArray* ptr_array, void* elem);


/**
 * Grows the given pointer array so that is has the given capacity.
 * The length of the array is not touched by this function.
 *
 * @param ptr_array the pointer array to which to add the new element,
 *        must not be NULL.
 * @param capacity the new capacity
 * @return zero for success, an error code otherwise
 */
int epr_grow_ptr_array(EPR_SPtrArray* ptr_array, unsigned int capacity);


/**
 * Returns the length of the given pointer array.
 * @param ptr_array the pointer array, must not be NULL.
 * @return the length of the given pointer array
 */
unsigned int epr_get_ptr_array_length(const EPR_SPtrArray* ptr_array);


/**
 * Returns the capacity of the given pointer array.
 * @param ptr_array the pointer array, must not be NULL.
 * @return the capacity of the given pointer array
 */
unsigned int epr_get_ptr_array_capacity(const EPR_SPtrArray* ptr_array);


/**
 * Gets the element with the specified index of the given pointer array.
 * @param ptr_array the pointer array, must not be NULL.
 * @param index the zero-based index, must be less than the array's length
 * @return the element at the given index
 */
void* epr_get_ptr_array_elem_at(const EPR_SPtrArray* ptr_array, unsigned int index);


#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* #ifndef EPR_PTRARRAY_H_INCL */