_NAME_ get_struct _PROTOTYPE_ structs = get_struct(secondsSince1996, structToUse) _SHORT-DESCRIPTION_ Get a data struct valid at a particular second-since-1996 _DESCRIPTION_ get_struct retrieves any data structure of type structName from the archives which was valid at time secondsSince1996. Beware that despite the singular nature of the name, an array of structs is always returned. This array is always terminated by a zeroed struct of type structName. The reason for this is that, due to some anomoly with the clock perhaps, more than 1 data struct may be stamped as valid during a particular interval, so there is a small chance of getting more than a single "valid" data struct back. There is a much better chance of the array only containing the terminal zeroed struct. In such a case, either no data exists during the interval or it has not yet been archived. - get_struct is really just a special case of get_structs, where both secondsSince1996Start and secondsSince1996Stop are set to the same value, secondsSince1996. _INPUT_ * secondsSince1996 is the second-since-1996 we are looking for valid data. * structToUse is a sample struct of the type data we are interested in retrieving. _OUTPUT_ * An array of structs terminated by a zeroed struct.