Apache 1.3 API Documentation

Routine ap_table_addn

Definition:

void ap_table_addn(table *t, const char *k, const char *val);
     

Usage example:

No examples available.
     

Adds a new value val to table t, associated with key. Pointers to the supplied strings are stored in the table, so they must either be constants or at least have a greater longevity than the table's pool, and they must not be modified after the entry has been added to the table. If these conditions cannot be met, you should use ap_table_add() instead.

A new table entry is always created, even if it duplicates another. To update an existing entry, or create it if it doesn't exist, use ap_table_setn().

If a table has multiple entries for a particular key, only the first will be returned by the direct lookup routines (e.g., ap_table_get()). The only way to access such duplicate entries is to traverse the table with ap_table_do().

See also:
ap_clear_table, ap_copy_table, ap_make_table, ap_overlay_tables, ap_table_add, ap_table_do, ap_table_get, ap_table_merge, ap_table_mergen, ap_table_set, ap_table_setn, ap_table_unset, table

Previous: ap_table_add Next: ap_table_do

Table of Contents (Routines, Structures, Data Cells, Constants)