1000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* 2000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * This file is part of ltrace. 3000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * Copyright (C) 2011,2012 Petr Machata, Red Hat Inc. 4000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * 5000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * This program is free software; you can redistribute it and/or 6000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * modify it under the terms of the GNU General Public License as 7000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * published by the Free Software Foundation; either version 2 of the 8000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * License, or (at your option) any later version. 9000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * 10000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * This program is distributed in the hope that it will be useful, but 11000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * WITHOUT ANY WARRANTY; without even the implied warranty of 12000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 13000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * General Public License for more details. 14000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * 15000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * You should have received a copy of the GNU General Public License 16000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * along with this program; if not, write to the Free Software 17000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 18000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * 02110-1301 USA 19000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata */ 20000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 21000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata#ifndef ARGS_H 22000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata#define ARGS_H 23000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 24000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata#include "forward.h" 25000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata#include "vect.h" 26000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 27000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Value dictionary is used to store actual function arguments. It 28000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * supports both numbered and named arguments. */ 29000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machatastruct value_dict 30000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata{ 31000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata struct vect numbered; 32000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata struct vect named; 33000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata}; 34000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 35000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Initialize DICT. */ 36000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machatavoid val_dict_init(struct value_dict *dict); 37000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 38000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Clone SOURCE into TARGET. Return 0 on success or a negative value 39000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * on failure. */ 40000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machataint val_dict_clone(struct value_dict *target, struct value_dict *source); 41000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 42000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Push next numbered value, VAL. The value is copied over and the 43000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * dictionary becomes its owner, and is responsible for destroying it 44000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * later. Returns 0 on success and a negative value on failure. */ 45000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machataint val_dict_push_next(struct value_dict *dict, struct value *val); 46000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 47000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Return count of numbered arguments. */ 48000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machatasize_t val_dict_count(struct value_dict *dict); 49000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 50000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Push value VAL named NAME. See notes at val_dict_push_next about 51000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * value ownership. The name is owned and freed if OWN_NAME is 52000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * non-zero. */ 53000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machataint val_dict_push_named(struct value_dict *dict, struct value *val, 54000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata const char *name, int own_name); 55000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 56000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Get NUM-th numbered argument, or NULL if there's not that much 57000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * arguments. */ 58000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machatastruct value *val_dict_get_num(struct value_dict *dict, size_t num); 59000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 60000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Get argument named NAME, or NULL if there's no such argument. */ 61000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machatastruct value *val_dict_get_name(struct value_dict *dict, const char *name); 62000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 63000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata/* Destroy the dictionary and all the values in it. Note that DICT 64000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata * itself (the pointer) is not freed. */ 65000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machatavoid val_dict_destroy(struct value_dict *dict); 66000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata 67000e31195ad4ad30a0c80c93ab57a424e7d8d918Petr Machata#endif /* ARGS_H */ 68