diff options
author | Bill Wendling <wendling@ncsa.uiuc.edu> | 2000-12-11 18:49:53 (GMT) |
---|---|---|
committer | Bill Wendling <wendling@ncsa.uiuc.edu> | 2000-12-11 18:49:53 (GMT) |
commit | a44b5b4725b3666eb69276b45712b22aef257fb9 (patch) | |
tree | 1d866fc3cc6b534695c7228c480d32bd104232f2 /doc/html/ddl.html | |
parent | 898110c9cf1285eaff0ffc37c670dcce28f139a0 (diff) | |
download | hdf5-a44b5b4725b3666eb69276b45712b22aef257fb9.zip hdf5-a44b5b4725b3666eb69276b45712b22aef257fb9.tar.gz hdf5-a44b5b4725b3666eb69276b45712b22aef257fb9.tar.bz2 |
[svn-r3109] Purpose:
Reformatting
Description:
Also changed how some of the lists were specified to be recursive
in the BNF style.
Platforms tested:
Netscrape
Diffstat (limited to 'doc/html/ddl.html')
-rw-r--r-- | doc/html/ddl.html | 122 |
1 files changed, 68 insertions, 54 deletions
diff --git a/doc/html/ddl.html b/doc/html/ddl.html index 6bf109f..1a7422f 100644 --- a/doc/html/ddl.html +++ b/doc/html/ddl.html @@ -70,6 +70,8 @@ This section contains a brief explanation of the symbols used in the DDL. <a><FONT SIZE=1.7>opt</FONT> zero or one occurrence of <a> <a>* zero or more occurrence of <a> <a>+ one or more occurrence of <a> + [0-9] an element in the range between 0 and 9 + `[' the token within the quotes (used for special characters) TBD To Be Decided </pre> @@ -86,30 +88,36 @@ This section contains a brief explanation of the symbols used in the DDL. <super_block_content> ::= TBD <root_group> ::= GROUP "/" { <unamed_datatype>* <object_id><FONT SIZE=1.7>opt</FONT> - <group_attribute>* <group_member>* } + <group_attribute>* <group_member>* } -<datatype> ::= <atomic_type> | <compound_type> | <variable_length_type> | - <array_type> +<datatype> ::= <atomic_type> | <compound_type> | <variable_length_type> | <array_type> <unamed_datatype> ::= DATATYPE <unamed_type_name> { <datatype> } <unamed_type_name> ::= the assigned name for unamed type is in the form of - #oid1:oid2, where oid1 and oid2 are the object ids of the type - -<atomic_type> ::= <integer> | <float> | <time> | <string> | <bitfield> | - <opaque> | <reference> | <enum> - -<integer> ::= H5T_STD_I8BE | H5T_STD_I8LE | H5T_STD_I16BE | - H5T_STD_I16LE | H5T_STD_I32BE | H5T_STD_I32LE | H5T_STD_I64BE | - H5T_STD_I64LE | H5T_STD_U8BE | H5T_STD_U8LE | H5T_STD_U16BE | - H5T_STD_U16LE | H5T_STD_U32BE | H5T_STD_U32LE | H5T_STD_U64BE | - H5T_STD_U64LE | H5T_NATIVE_CHAR | H5T_NATIVE_UCHAR | - H5T_NATIVE_SHORT | H5T_NATIVE_USHORT | H5T_NATIVE_INT | - H5T_NATIVE_UINT | H5T_NATIVE_LONG | H5T_NATIVE_ULONG | - H5T_NATIVE_LLONG | H5T_NATIVE_ULLONG - -<float> ::= H5T_IEEE_F32BE | H5T_IEEE_F32LE | H5T_IEEE_F64BE | - H5T_IEEE_F64LE | H5T_NATIVE_FLOAT | H5T_NATIVE_DOUBLE | + #oid1:oid2, where oid1 and oid2 are the object ids + of the type + +<atomic_type> ::= <integer> | <float> | <time> | <string> | + <bitfield> | <opaque> | <reference> | <enum> + +<integer> ::= H5T_STD_I8BE | H5T_STD_I8LE | + H5T_STD_I16BE | H5T_STD_I16LE | + H5T_STD_I32BE | H5T_STD_I32LE | + H5T_STD_I64BE | H5T_STD_I64LE | + H5T_STD_U8BE | H5T_STD_U8LE | + H5T_STD_U16BE | H5T_STD_U16LE | + H5T_STD_U32BE | H5T_STD_U32LE | + H5T_STD_U64BE | H5T_STD_U64LE | + H5T_NATIVE_CHAR | H5T_NATIVE_UCHAR | + H5T_NATIVE_SHORT | H5T_NATIVE_USHORT | + H5T_NATIVE_INT | H5T_NATIVE_UINT | + H5T_NATIVE_LONG | H5T_NATIVE_ULONG | + H5T_NATIVE_LLONG | H5T_NATIVE_ULLONG + +<float> ::= H5T_IEEE_F32BE | H5T_IEEE_F32LE | + H5T_IEEE_F64BE | H5T_IEEE_F64LE | + H5T_NATIVE_FLOAT | H5T_NATIVE_DOUBLE | H5T_NATIVE_LDOUBLE <time> ::= TBD @@ -119,7 +127,7 @@ This section contains a brief explanation of the symbols used in the DDL. CSET <cset> ; CTYPE <ctype> ; } -<strsize> ::= an integer +<strsize> ::= <int_value> <strpad> ::= H5T_STR_NULLTERM | H5T_STR_NULLPAD | H5T_STR_SPACEPAD @@ -141,12 +149,13 @@ This section contains a brief explanation of the symbols used in the DDL. <field_name> ::= <identifier> -<variable_length_type> ::= H5T_VLEN { <datatype> } +<variable_length_type> ::= H5T_VLEN { <datatype> } <array_type> ::= H5T_ARRAY { <dim_sizes> <datatype> } -<dim_sizes> ::= [dimsize1][dimsize2]... -// where dimsize1, dimsize2 are integers +<dim_sizes> ::= `['<dimsize>`]' | `['<dimsize>`]'<dim_sizes> + +<dimsize> ::= <int_value> <attribute> ::= ATTRIBUTE <attr_name> { <dataset_type> <dataset_space> @@ -166,13 +175,13 @@ This section contains a brief explanation of the symbols used in the DDL. <enum_symbol> ::= <identifier> -<enum_val> ::= an integer; +<enum_val> ::= <int_value> <path_name> ::= <path_part>+ <path_part> ::= /<identifier> -<dataspace> ::= <scalar_space> | <simple_space> | <complex_space> +<dataspace> ::= <scalar_space> | <simple_space> | <complex_space> <scalar_space> ::= SCALAR @@ -182,27 +191,26 @@ This section contains a brief explanation of the symbols used in the DDL. <dataset_space> ::= DATASPACE <path_name> | <dataspace> -<current_dims> ::= (<i>i<FONT SIZE=1.0>1</i></FONT>, <i>i<FONT SIZE=1.0>2</i></FONT>, ... ), where <i>i<FONT SIZE=1.0>k</i></FONT> is an integer, <i>k</i> = 1,2,... +<current_dims> ::= <dims> <max_dims> ::= (<i>i<FONT SIZE=1.0>1</i></FONT>, <i>i<FONT SIZE=1.0>2</i></FONT>, ... ) where <i>i<FONT SIZE=1.0>k</i></FONT> is an integer or H5S_UNLIMITED <complex_space_definition> ::= TBD -<data> ::= DATA { <scalar_space_data> | <simple_space_data> | - <complex_space_data> } +<data> ::= DATA { <scalar_space_data> | <simple_space_data> | <complex_space_data> } <scalar_space_data> ::= <any_element> <any_element> ::= <atomic_element> | <compound_element> | - <variable_length_element> | <array_element> + <variable_length_element> | <array_element> <any_data_seq> ::= <any_element> | <any_element>, <any_data_seq> -<atomic_element> :: = <integer_data> | <float_data> | <time_data> | - <string_data> | <bitfield_data> | <opaque_data> | - <enum_data> | <reference_data> +<atomic_element> :: = <integer_data> | <float_data> | <time_data> | + <string_data> | <bitfield_data> | <opaque_data> | + <enum_data> | <reference_data> -<integer_data> ::= an integer +<integer_data> ::= <int_value> <float_data> ::= a floating point number @@ -227,32 +235,34 @@ This section contains a brief explanation of the symbols used in the DDL. <object_id> ::= OBJECTID { <object_num> } -<object_num> ::= an integer:an integer | an integer +<object_num> ::= <int_value>:<int_value> | <int_value> <data_region_data> ::= H5T_STD_REF_DSETREG <object_num> { <data_region_data_info>, <data_region_data_info>, ...} <data_region_data_info> ::= <region_info> | <point_info> -<region_info> ::= (<lower_bound>:<upper_bound>, - <lower_bound>:<upper_bound>, ...) +<region_info> ::= (<region_vals>) + +<region_vals> ::= <lower_bound>:<upper_bound> | <lower_bound>:<upper_bound>, <region_vals> -<lower_bound> ::= an integer +<lower_bound> ::= <int_value> -<upper_bound> ::= an integer +<upper_bound> ::= <int_value> -<point_info> ::= (an integer, an integer, ...) +<point_info> ::= (<point_vals>) + +<point_vals> ::= <int_value> | <int_value>, <point_vals> <compound_element> ::= { <any_data_seq> } -<atomic_simple_data> :: = <atomic_element>, <atomic_simple_data> | - <atomic_element> +<atomic_simple_data> :: = <atomic_element>, <atomic_simple_data> | <atomic_element> <simple_space_data> :: = <any_data_seq> <variable_length_element> ::= ( <any_data_seq> ) -<array_element> ::= [ <any_data_seq> ] +<array_element> ::= `[' <any_data_seq> `]' <complex_space_data> ::= TBD @@ -273,28 +283,30 @@ This section contains a brief explanation of the symbols used in the DDL. <group_attribute> ::= <attribute> <group_member> ::= <named_datatype> | <named_dataspace> | <group> | - <dataset> | <softlink> + <dataset> | <softlink> <dataset> ::= DATASET <dataset_name> { <hardlink> | <dataset_info> } <dataset_info> ::= <dataset_type> <dataset_space> <storagelayout><FONT SIZE=1.7>opt</FONT> - <compression><FONT SIZE=1.7>opt</FONT> <dataset_attribute>* <object_id><FONT SIZE=1.7>opt</FONT> - <data><FONT SIZE=1.7>opt</FONT> + <compression><FONT SIZE=1.7>opt</FONT> <dataset_attribute>* <object_id><FONT SIZE=1.7>opt</FONT> + <data><FONT SIZE=1.7>opt</FONT> // Tokens above can be in any order as long as <data> is // after <dataset_type> and <dataset_space>. <dataset_name> ::= <identifier> <storagelayout> :: = STORAGELAYOUT <contiguous_layout> | - STORAGELAYOUT <chunked_layout> | - STORAGELAYOUT <compact_layout> | + STORAGELAYOUT <chunked_layout> | + STORAGELAYOUT <compact_layout> | STORAGELAYOUT <external_layout> <contiguous_layout> ::= {CONTIGUOUS} // default <chunked_layout> ::= {CHUNKED <dims> } -<dims> ::= (<i>i<FONT SIZE=1.0>1</i></FONT>, <i>i<FONT SIZE=1.0>2</i></FONT>, ... ), <i>i<FONT SIZE=1.0>k</i></FONT> is an integer, <i>k</i> = 1,2,... +<dims> ::= (<dims_values>) + +<dims_values> ::= <int_value> | <int_value>, <dims_values> <compact_layout> ::= TBD @@ -302,9 +314,9 @@ This section contains a brief explanation of the symbols used in the DDL. <external_file> ::= (<file_name> <offset> <size>) -<offset> ::= an integer +<offset> ::= <int_value> -<size> ::= an integer +<size> ::= <int_value> <compression> :: = COMPRESSION { TBD } @@ -316,16 +328,18 @@ This section contains a brief explanation of the symbols used in the DDL. <target> ::= <identifier> -<identifier> ::= string +<identifier> ::= a string // character '/' should be used with care. +<int_value> ::= 0 | [1-9][0-9]* + </PRE> -</dir> +</DIR> -<h2>4. An Example of an HDF5 File in DDL</h2> +<H2>4. An Example of an HDF5 File in DDL</H2> -<dir> +<DIR> <PRE> HDF5 "example.h5" { GROUP "/" { |