_NAME_
get_structs

_PROTOTYPE_
structs = get_structs(secondsSince1996Start, secondsSince1996Stop, structToUse)

_SHORT-DESCRIPTION_
Get a set of data structs between a start and a stop time

_DESCRIPTION_
get_structs retrieves any data structures of type structToUse from the
archives which were valid between the start time,
secondsSince1996Start, and the stop time, secondsSince1996Stop
(But see the note below for an important clarification of exactly what
this means.)  An array of structs of type structToUse is returned.
This array is always terminated by a zeroed struct of type structToUse. 
_
The start and stop times used in get_structs can be across an arbitrary
time interval. This may cause problems if users abuse it. In other
words, get_structs allocates an arbitrary amount of
memory for the struct array it will be creating. Users should be
warned about this (though they should be accessing get_structs via
a more user friendly wrapper like getGroupHiRates_s or the like, the
same warning applies there.)
_
Note: A structure which is valid at the time secondsSince1996Start
will always be returned by this call, but the structure valid at
secondsSince1996Stop will not be returned unless it is the same
structure which is valid at secondsSince1996Start. Any and all
structures valid at times between secondsSince1996Start and
secondsSince1996Stop will be returned (which seems too obvious to
state.) The reason that the last structure (the one valid at
secondsSince1996Stop) is not returned by this call is to prevent
seemingly contiguous calls to get_structs from returning overlapping
data. For this reason, any series of calls to get_structs for contiguous
data must use the prior secondsSince1996Stop as the
secondsSince1996Start for the new call. Otherwise there will be a 1
second gap in each call's time intervals. 

_INPUT_
* secondsSince1996Start is the start second on which to look for valid
data.  See note above for specifics.
* secondsSince1996Stop is the stop second for the data retrieval.  See
note above for specifics.
* structToUse is an instance of a structure for the data type we are requesting.

_OUTPUT_
* An array of data structs terminated by a zeroed struct of the same type.