#include <AttrTable.h>
Inheritance diagram for AttrTable:
Instance management functions | |
AttrTable (const AttrTable &rhs) | |
AttrTable () | |
AttrTable & | operator= (const AttrTable &rhs) |
virtual | ~AttrTable () |
Public Types | |
typedef std::vector< entry * >::const_iterator | Attr_citer |
typedef std::vector< entry * >::iterator | Attr_iter |
Public Member Functions | |
void | add_container_alias (const string &name, AttrTable *src) |
Add an alias to a container held by this attribute table. | |
void | add_value_alias (AttrTable *das, const string &name, const string &source) |
Add an alias for an attribute. | |
unsigned int | append_attr (const string &name, const string &type, vector< string > *values) |
Add an attribute to the table. | |
unsigned int | append_attr (const string &name, const string &type, const string &value) |
Add an attribute to the table. | |
AttrTable * | append_container (AttrTable *at, const string &name) |
Add a container to the attribute table. | |
AttrTable * | append_container (const string &name) |
Add a container to the attribute table. | |
bool | attr_alias (const string &alias, const string &name) |
bool | attr_alias (const string &alias, AttrTable *at, const string &name) |
Adds an alias to the set of attributes. | |
virtual void | dump (ostream &strm) const |
dumps information about this object | |
void | erase () |
Erase the attribute table. | |
void | find (const string &target, AttrTable **at, Attr_iter *iter) |
AttrTable * | find_container (const string &target) |
Find an attribute with a given name. | |
string | get_name () const |
Get the name of this attribute table. | |
AttrTable * | get_parent () const |
unsigned int | get_size () const |
Get the number of entries in this attribute table. | |
void | print (FILE *out, string pad=" ", bool dereference=false) |
Prints the attribute table. | |
void | print_xml (FILE *out, string pad=" ", bool constrained=false) |
AttrTable * | recurrsive_find (const string &target, Attr_iter *location) |
void | set_name (const string &n) |
Set the name of this attribute table. | |
get information using an iterator | |
Attr_iter | attr_begin () |
Attr_iter | attr_end () |
Attr_iter | del_attr_table (Attr_iter iter) |
string | get_attr (Attr_iter iter, unsigned int i=0) |
string | get_attr (const string &name, unsigned int i=0) |
Attr_iter | get_attr_iter (int i) |
unsigned int | get_attr_num (Attr_iter iter) |
AttrTable * | get_attr_table (Attr_iter iter) |
AttrType | get_attr_type (Attr_iter iter) |
std::vector< string > * | get_attr_vector (Attr_iter iter) |
string | get_name (Attr_iter iter) |
string | get_type (Attr_iter iter) |
bool | is_container (Attr_iter iter) |
Accessors using an attribute name | |
Each of the following accessors get information using the name of an attribute. They perform a simple search for the name in this attribute table only; sub-tables are not searched and the dot notation is not recognized. | |
void | del_attr (const string &name, int i=-1) |
Deletes an attribute. | |
unsigned int | get_attr_num (const string &name) |
Get the number of attributes in this container. | |
AttrTable * | get_attr_table (const string &name) |
Get an attribute container. | |
AttrType | get_attr_type (const string &name) |
Get the type of an attribute. | |
vector< string > * | get_attr_vector (const string &name) |
Get a vector-valued attribute. | |
string | get_type (const string &name) |
Get the type name of an attribute within this attribute table. | |
Protected Member Functions | |
void | clone (const AttrTable &at) |
void | simple_print (FILE *out, string pad, Attr_iter i, bool dereference) |
Friends | |
class | AttrTableTest |
AttrType
list. However, all attribute types are stored as string data, except for the container type, which is stored as a pointer to another attribute table.Each element in the attribute table can itself be an attribute table. The table can also contain ``alias'' attributes whose value is given by the value of another attribute to which it is linked.
The attribute tables have a standard printed representation. There is a member function print()
for writing this form. Use the DAS::parse()
function to read the printed form.
An attribute table might look something like this:
string long_name "Weekly Means of Sea Surface Temperature"; actual_range { Float64 min -1.8; Float64 max 35.09; } string units "degC"; conversion_data { Float64 add_offset 0.; Float64 scale_factor 0.0099999998; } Int32 missing_value 32767;
Here, long_name
, units
, and missing_value
are simple attributes, and actual_range
and conversion_data
are container attributes containing other attribute tables.
A problem with this class is that Attr_iter objects cannot be dereferenced to return attributes. Instead they must be passed to methods which require that you have access to the AttrTable object into which they point.03/09/04 jhrg
Definition at line 141 of file AttrTable.h.
|
Definition at line 226 of file AttrTable.h. |
|
Definition at line 227 of file AttrTable.h. Referenced by add_value_alias(), append_attr(), del_attr(), erase(), get_attr(), get_attr_num(), get_attr_type(), get_attr_vector(), get_type(), print(), print_xml(), and recurrsive_find(). |
|
Definition at line 123 of file AttrTable.cc. Referenced by AttrTable::entry::clone(). |
|
Definition at line 126 of file AttrTable.cc. References clone(). |
Here is the call graph for this function:
|
Definition at line 140 of file AttrTable.cc. References DBG. |
|
Definition at line 789 of file AttrTable.cc. References AttrTable::entry::aliased_to, attr_end(), AttrTable::entry::attributes, get_name(), AttrTable::entry::is_alias, AttrTable::entry::name, AttrTable::entry::type, and www2id(). |
Here is the call graph for this function:
|
Assume source names an attribute value in some container. Add an alias name for that value in this object.
Definition at line 821 of file AttrTable.cc. References AttrTable::entry::aliased_to, AttrTable::entry::attr, attr_end(), Attr_iter, AttrTable::entry::attributes, find(), get_attr_table(), get_attr_type(), AttrTable::entry::is_alias, is_container(), AttrTable::entry::name, AttrTable::entry::type, and www2id(). Referenced by attr_alias(). |
Here is the call graph for this function:
|
This version of append_attr() takes a vector<string> of values. If the given name already refers to an attribute, and the attribute has values, append the new values to the existing ones.
The function throws an Error if the attribute is a container, or if the type of the input value does not match the existing attribute's type. Use
This method performs a simple search for
Definition at line 257 of file AttrTable.cc. References AttrTable::entry::attr, Attr_iter, get_type(), AttrTable::entry::is_alias, AttrTable::entry::name, String_to_AttrType(), AttrTable::entry::type, and www2id(). |
Here is the call graph for this function:
|
If the given name already refers to an attribute, and the attribute has a value, the given value is appended to the attribute vector. Calling this function repeatedly is the way to append to an attribute vector.
The function throws an Error if the attribute is a container, or if the type of the input value does not match the existing attribute's type. Use
This method performs a simple search for
Definition at line 204 of file AttrTable.cc. References AttrTable::entry::attr, Attr_iter, get_type(), AttrTable::entry::is_alias, AttrTable::entry::name, String_to_AttrType(), AttrTable::entry::type, and www2id(). Referenced by DDXParser::ddx_end_element(), DDS::transfer_attributes(), and Constructor::transfer_attributes(). |
Here is the call graph for this function:
|
Append a new attribute container to this attribute table. The new container is
Definition at line 331 of file AttrTable.cc. References attr_end(), AttrTable::entry::attributes, d_parent, DBG, AttrTable::entry::is_alias, AttrTable::entry::name, set_name(), AttrTable::entry::type, and www2id(). |
Here is the call graph for this function:
|
Create and append an attribute container to this AttrTable. If this attribute table already contains an attribute container called
Definition at line 303 of file AttrTable.cc. Referenced by DAS::add_table(), DAS::DAS(), DDS::find_matching_container(), Constructor::find_matching_container(), DDS::transfer_attributes(), and Constructor::transfer_attributes(). |
|
Definition at line 901 of file AttrTable.cc. References attr_alias(). |
Here is the call graph for this function:
|
Once an alias is inserted into an attribute table, reading the attributes for alias will return those stored for name.
Two forms for this function exist: one searches for name in the AttrTable referenced by at while the other uses
Definition at line 887 of file AttrTable.cc. References add_value_alias(). Referenced by attr_alias(). |
Here is the call graph for this function:
|
Get an iterator to the first entry in this attribute table.
Definition at line 609 of file AttrTable.cc. Referenced by print_xml(), recurrsive_find(), DDS::transfer_attributes(), Constructor::transfer_attributes(), and DAS::var_begin(). |
|
Get an iterator to the end attribute table. Does not point to the last attribute in the table
Definition at line 618 of file AttrTable.cc. Referenced by add_container_alias(), add_value_alias(), append_container(), print_xml(), recurrsive_find(), DDS::transfer_attributes(), Constructor::transfer_attributes(), and DAS::var_end(). |
|
Clone the given attribute table in Definition at line 106 of file AttrTable.cc. References Attr_citer, attr_map, d_name, and d_parent. Referenced by AttrTable(), AttrTable::entry::entry(), AttrTable::entry::operator=(), and operator=(). |
|
Delete the attribute named
You can use this function to delete container attributes, although the
Definition at line 577 of file AttrTable.cc. References AttrTable::entry::attr, Attr_iter, erase(), and www2id(). |
Here is the call graph for this function:
|
Delete the iterator. Since AttrTable stores pointers to AttrTable objects, the caller should be sure to delete the AttrTable itself. This method does not take care of that operation.
Definition at line 673 of file AttrTable.cc. References erase(). |
Here is the call graph for this function:
|
Displays the pointer value of this instance and all attributes stored
Implements DapObj. Reimplemented in DAS. Definition at line 1044 of file AttrTable.cc. References AttrTable::entry::aliased_to, AttrTable::entry::attr, Attr_citer, AttrTable::entry::attributes, AttrType_to_String(), DapIndent::Indent(), AttrTable::entry::is_alias, AttrTable::entry::name, AttrTable::entry::type, and DapIndent::UnIndent(). Referenced by DDS::dump(), DAS::dump(), Constructor::dump(), and BaseType::dump(). |
Here is the call graph for this function:
|
Erase the entire attribute table. This returns an AttrTable to the empty state that's the same as the object generated by the null constructor. Definition at line 910 of file AttrTable.cc. References Attr_iter. Referenced by del_attr(), del_attr_table(), and AISMerge::merge(). |
|
Look for an attribute or an attribute container. If used to search for an attribute container, this method returns the container's parent using the value-result parameter
Definition at line 370 of file AttrTable.cc. References find_container(), recurrsive_find(), and simple_find(). Referenced by add_value_alias(), and find_container(). |
Here is the call graph for this function:
|
Look in this attribute table for an attribute container named To search the entire DAS object, make sure to invoke this method from that object.
Definition at line 464 of file AttrTable.cc. References find(). Referenced by DAS::das_find(), find(), DDS::find_matching_container(), Constructor::find_matching_container(), and get_attr_table(). |
Here is the call graph for this function:
|
Returns the value of an attribute. If the attribute has a vector value, you can indicate which is the desired value with the index argument, i. If the argument is omitted, the first value is returned. If the attribute has only a single value, the index argument is ignored. If i is greater than the number of elements in the attribute, an error is produced. All values in an attribute table are stored as string data. They may be converted to a more appropriate internal format by the calling program.
Definition at line 733 of file AttrTable.cc. References Attr_container. |
|
Definition at line 756 of file AttrTable.cc. References Attr_iter. Referenced by print_xml(). |
|
Given an index
Definition at line 632 of file AttrTable.cc. |
|
If the attribute referenced by iter is a container attribute, this method returns the number of attributes in its attribute table. If the indicated attribute is not a container, the method returns the number of values for the attribute (1 for a scalar attribute, N for a vector attribute value).
Definition at line 708 of file AttrTable.cc. References get_size(). |
Here is the call graph for this function:
|
If the indicated attribute is a container attribute, this function returns the number of attributes in its attribute table. If the indicated attribute is not a container, the method returns the number of values for the attribute (1 for a scalar attribute, N for a vector attribute value). Definition at line 535 of file AttrTable.cc. References Attr_iter. Referenced by print_xml(). |
|
Get the attribute container referenced by iter. If no such container exists, then return a reference to the end of the table.
Definition at line 659 of file AttrTable.cc. References Attr_container. |
|
Definition at line 505 of file AttrTable.cc. References find_container(). Referenced by add_value_alias(), DAS::get_table(), and print_xml(). |
Here is the call graph for this function:
|
Get the type of the attribute referenced by iter.
Definition at line 695 of file AttrTable.cc. |
|
Definition at line 521 of file AttrTable.cc. References Attr_iter. Referenced by add_value_alias(). |
|
Returns a pointer to the vector of values associated with the attribute referenced by iterator iter. Note that all values in an attribute table are stored as string data. They may be converted to a more appropriate internal format by the calling program.
Definition at line 774 of file AttrTable.cc. References Attr_container. |
|
Get a pointer to the vector of values associated with the attribute referenced by Pix Note that all values in an attribute table are stored as string data. They may be converted to a more appropriate internal format by the calling program.
Definition at line 554 of file AttrTable.cc. References Attr_iter. Referenced by DDS::transfer_attributes(), and Constructor::transfer_attributes(). |
|
Returns the name of the attribute referenced by iter. Definition at line 639 of file AttrTable.cc. References AttrTable::entry::name. |
|
Definition at line 173 of file AttrTable.cc. Referenced by add_container_alias(), DAS::get_name(), print(), print_xml(), simple_print(), DDS::transfer_attributes(), and Constructor::transfer_attributes(). |
|
Return a pointer to the AttrTable which holds this table (aka, its parent. If this AttrTable has no parent, this returns null.
Definition at line 261 of file AttrTable.h. |
|
Attributes that are containers count one attribute, as do attributes with both scalar and vector values.
Definition at line 165 of file AttrTable.cc. Referenced by get_attr_num(), AISMerge::merge(), and BaseType::print_xml(). |
|
Get the type name of an attribute referenced by iter.
Definition at line 685 of file AttrTable.cc. References AttrType_to_String(). |
Here is the call graph for this function:
|
Definition at line 512 of file AttrTable.cc. References Attr_iter. Referenced by append_attr(), print_xml(), simple_print(), DDS::transfer_attributes(), and Constructor::transfer_attributes(). |
|
Returns true if the attribute referenced by i is a container. Definition at line 648 of file AttrTable.cc. References AttrTable::entry::type. Referenced by add_value_alias(), and print_xml(). |
|
Definition at line 148 of file AttrTable.cc. References clone(). |
Here is the call graph for this function:
|
Prints an ASCII representation of the attribute table to the indicated FILE pointer. The
Definition at line 964 of file AttrTable.cc. References Attr_iter, get_name(), id2www(), and simple_print(). Referenced by DAS::print(), and simple_print(). |
Here is the call graph for this function:
|
Print the attribute table in XML.
Definition at line 990 of file AttrTable.cc. References attr_begin(), attr_end(), Attr_iter, get_attr(), get_attr_num(), get_attr_table(), get_name(), get_type(), id2xml(), and is_container(). Referenced by Grid::print_xml(), DDS::print_xml(), Constructor::print_xml(), BaseType::print_xml(), and Array::print_xml_core(). |
Here is the call graph for this function:
|
This method scans for attributes using recursion to look inside containers even when the name of the attribute is not fully qualified. It starts looking in itself and descends into its children depth first. It will find attributes and attribute containers.
Definition at line 409 of file AttrTable.cc. References attr_begin(), attr_end(), and Attr_iter. Referenced by find(). |
Here is the call graph for this function:
|
Definition at line 181 of file AttrTable.cc. References www2id(). Referenced by append_container(). |
Here is the call graph for this function:
|
A simple printer that does nothing fancy with aliases. Protected. Definition at line 925 of file AttrTable.cc. References Attr_container, AttrTable::entry::attributes, get_name(), get_type(), id2www(), and print(). Referenced by print(). |
Here is the call graph for this function:
|
Definition at line 239 of file AttrTable.h. |