table of contents
other versions
- wheezy 0.7.3-6
- jessie 0.7.3-6+b2
- testing 0.9.4-1
- unstable 0.9.4-1
- experimental 0.10.0-1
gd_madd_bit(3) | GETDATA | gd_madd_bit(3) |
NAME¶
gd_madd_bit, gd_madd_carray, gd_madd_clincom, gd_madd_const, gd_madd_cpolynom, gd_madd_crecip, gd_madd_divide, gd_madd_lincom, gd_madd_linterp, gd_madd_multiply, gd_madd_phase, gd_madd_polynom, gd_madd_recip, gd_madd_sbit, gd_madd_string — add a field to a dirfileSYNOPSIS¶
#include <getdata.h>int
gd_madd_bit(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*in_field, gd_bit_t bitnum, gd_bit_t
numbits);
int
gd_madd_carray(DIRFILE *dirfile, const char
*parent, const char *field_name, gd_type_t
const_type, size_t array_len, gd_type_t
data_type, void *value);
int
gd_madd_clincom(DIRFILE *dirfile, const char
*parent, const char *field_name, int
n_fields, const char **in_fields, const
double complex *cm, const double complex
*cb);
int
gd_madd_const(DIRFILE *dirfile, const char
*parent, const char *field_name, gd_type_t
const_type, gd_type_t data_type, void
*value);
int
gd_madd_cpolynom(DIRFILE *dirfile, const char
*parent, const char *field_name, int
poly_ord, const char *in_field, const
double complex *ca);
int
gd_madd_crecip(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*in_field, double complex cdividend, int
fragment_index);
int
gd_madd_divide(DIRFILE *dirfile, const char
*parent, const char *field_name, const
char *in_field1, const char *in_field2);
int
gd_madd_lincom(DIRFILE *dirfile, const char
*parent, const char *field_name, int
n_fields, const char **in_fields, const
double *m, const double *b);
int
gd_madd_linterp(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*in_field, const char *table);
int
gd_madd_multiply(DIRFILE *dirfile, const char
*parent, const char *field_name, const
char *in_field1, const char *in_field2);
int
gd_madd_polynom(DIRFILE *dirfile, const char
*parent, const char *field_name, int
poly_ord, const char *in_field, const
double *a);
int
gd_madd_phase(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*in_field, gd_shift_t shift);
int
gd_madd_recip(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*in_field, double dividend, int
fragment_index);
int
gd_madd_sbit(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*in_field, gd_bit_t bitnum, gd_bit_t
numbits);
int
gd_madd_string(DIRFILE *dirfile, const char
*parent, const char *field_name, const char
*value);
DESCRIPTION¶
These functions provide alternatives to using the gd_madd() function to add a new metafield of the indicated type under the parent field given by parent in the dirfile specified by dirfile. In all of these calls, field_name indicates the name of the field to be added. It should not be the full <parent-field>/<meta-field> field code. The meaning and valid types of other arguments may be obtained from the gd_entry(3) and dirfile-format(5) manual pages.RETURN VALUE¶
On success, any of these functions returns zero. On error, -1 is returned and the dirfile error is set to a non-zero error value. Possible error values are:- GD_E_ACCMODE
- The specified dirfile was opened read-only.
- GD_E_ALLOC
- The library was unable to allocate memory.
- GD_E_BAD_CODE
- The field_name argument contained invalid characters. Alternately, the parent field code was not found, or was already a metafield.
- GD_E_BAD_DIRFILE
- The supplied dirfile was invalid.
- GD_E_BAD_ENTRY
- One or more of the field parameters specified was invalid.
- GD_E_BAD_TYPE
- The data_type or const_type argument provided to gd_madd_const() or gd_madd_carray() was invalid.
- GD_E_DUPLICATE
- The field_name provided duplicated that of an already existing field.
- GD_E_PROTECTED
- The metadata of the fragment was protected from change.
NOTES¶
The C89 GetData API provides different prototypes for gd_madd_clincom(), gd_madd_cpolynom(), and gd_madd_crecip():#define GD_C89_API #include <getdata.h>
int gd_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double *cm, const double *cb);
int gd_madd_cpolynom(DIRFILE *dirfile, const char *parent, const char *field_name, int poly_ord, const char *in_field, const double *ca);
int gd_madd_crecip(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, double cdividend[2], int fragment_index);
SEE ALSO¶
gd_add_bit(3), gd_add_const(3), gd_add_lincom(3), gd_add_linterp(3), gd_add_multiply(3), gd_add_phase(3), gd_add_string(3), gd_madd(3), gd_madd_spec(3), gd_metaflush(3), gd_open(3), gd_error(3), gd_error_string(3), dirfile-format(5)3 November 2010 | Version 0.7.0 |