xbps/include/xbps/xbps_array.h
Juan RP 43c9497feb Introduce xbps_array_add_first() to insert obj at the head of array.
The behaviour of this routine mimics the existing xbps_array_add() with
the difference that stored objects are moved to the right to insert
our object as the first element on the array.

Use this to add replaced packages in the transaction array at the head
rather than at the end, to preserve the proper sorting order.
2014-11-13 15:18:21 +01:00

152 lines
5.3 KiB
C

/* $NetBSD: prop_array.h,v 1.8 2008/09/11 13:15:13 haad Exp $ */
/*-
* Copyright (c) 2006 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Jason R. Thorpe.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef _XBPS_ARRAY_H_
#define _XBPS_ARRAY_H_
#include <stdint.h>
#include <xbps/xbps_object.h>
typedef struct _prop_array *xbps_array_t;
#ifdef __cplusplus
extern "C" {
#endif
xbps_array_t xbps_array_create(void);
xbps_array_t xbps_array_create_with_capacity(unsigned int);
xbps_array_t xbps_array_copy(xbps_array_t);
xbps_array_t xbps_array_copy_mutable(xbps_array_t);
unsigned int xbps_array_capacity(xbps_array_t);
unsigned int xbps_array_count(xbps_array_t);
bool xbps_array_ensure_capacity(xbps_array_t, unsigned int);
void xbps_array_make_immutable(xbps_array_t);
bool xbps_array_mutable(xbps_array_t);
xbps_object_iterator_t xbps_array_iterator(xbps_array_t);
xbps_object_t xbps_array_get(xbps_array_t, unsigned int);
bool xbps_array_set(xbps_array_t, unsigned int, xbps_object_t);
bool xbps_array_add(xbps_array_t, xbps_object_t);
bool xbps_array_add_first(xbps_array_t, xbps_object_t);
void xbps_array_remove(xbps_array_t, unsigned int);
bool xbps_array_equals(xbps_array_t, xbps_array_t);
char * xbps_array_externalize(xbps_array_t);
xbps_array_t xbps_array_internalize(const char *);
bool xbps_array_externalize_to_file(xbps_array_t, const char *);
bool xbps_array_externalize_to_zfile(xbps_array_t, const char *);
xbps_array_t xbps_array_internalize_from_file(const char *);
xbps_array_t xbps_array_internalize_from_zfile(const char *);
/*
* Utility routines to make it more convenient to work with values
* stored in dictionaries.
*/
bool xbps_array_get_bool(xbps_array_t, unsigned int,
bool *);
bool xbps_array_set_bool(xbps_array_t, unsigned int,
bool);
bool xbps_array_get_int8(xbps_array_t, unsigned int,
int8_t *);
bool xbps_array_get_uint8(xbps_array_t, unsigned int,
uint8_t *);
bool xbps_array_set_int8(xbps_array_t, unsigned int,
int8_t);
bool xbps_array_set_uint8(xbps_array_t, unsigned int,
uint8_t);
bool xbps_array_get_int16(xbps_array_t, unsigned int,
int16_t *);
bool xbps_array_get_uint16(xbps_array_t, unsigned int,
uint16_t *);
bool xbps_array_set_int16(xbps_array_t, unsigned int,
int16_t);
bool xbps_array_set_uint16(xbps_array_t, unsigned int,
uint16_t);
bool xbps_array_get_int32(xbps_array_t, unsigned int,
int32_t *);
bool xbps_array_get_uint32(xbps_array_t, unsigned int,
uint32_t *);
bool xbps_array_set_int32(xbps_array_t, unsigned int,
int32_t);
bool xbps_array_set_uint32(xbps_array_t, unsigned int,
uint32_t);
bool xbps_array_get_int64(xbps_array_t, unsigned int,
int64_t *);
bool xbps_array_get_uint64(xbps_array_t, unsigned int,
uint64_t *);
bool xbps_array_set_int64(xbps_array_t, unsigned int,
int64_t);
bool xbps_array_set_uint64(xbps_array_t, unsigned int,
uint64_t);
bool xbps_array_add_int8(xbps_array_t, int8_t);
bool xbps_array_add_uint8(xbps_array_t, uint8_t);
bool xbps_array_add_int16(xbps_array_t, int16_t);
bool xbps_array_add_uint16(xbps_array_t, uint16_t);
bool xbps_array_add_int32(xbps_array_t, int32_t);
bool xbps_array_add_uint32(xbps_array_t, uint32_t);
bool xbps_array_add_int64(xbps_array_t, int64_t);
bool xbps_array_add_uint64(xbps_array_t, uint64_t);
bool xbps_array_get_cstring(xbps_array_t, unsigned int,
char **);
bool xbps_array_set_cstring(xbps_array_t, unsigned int,
const char *);
bool xbps_array_add_cstring(xbps_array_t, const char *);
bool xbps_array_add_cstring_nocopy(xbps_array_t,
const char *);
bool xbps_array_get_cstring_nocopy(xbps_array_t,
unsigned int,
const char **);
bool xbps_array_set_cstring_nocopy(xbps_array_t,
unsigned int,
const char *);
bool xbps_array_add_and_rel(xbps_array_t, xbps_object_t);
#ifdef __cplusplus
}
#endif
#endif /* _XBPS_ARRAY_H_ */