Procedure

   SpiceBoolean wnincd_c ( SpiceDouble     left,
                           SpiceDouble     right,
                           SpiceCell     * window ) 

Abstract

 
   Determine whether an interval is included in a double precision 
   window. 
 

Required_Reading

 
   WINDOWS 
 

Keywords

 
   WINDOWS 
 

Brief_I/O

 
   VARIABLE  I/O  DESCRIPTION 
   --------  ---  -------------------------------------------------- 
   left, 
   right      I   Input interval. 
   window     I   Input window. 

   The function returns SPICETRUE if the input interval is included in
   ---is a subset of some interval in---window.  
 

Detailed_Input

 
   left, 
   right       are the endpoints of an interval, which may or 
               may not be contained in one of the intervals in 
               window. 

   window      is a CSPICE window containing zero or more intervals. 

               window must be declared as a double precision SPICECELL.
 

Detailed_Output

 
   The function returns SPICETRUE if the input interval is included 
   in the input window---that is, if 

      a(i)  <  left  <  right  <  b(i) 
            -        -         - 

   for some interval [ a(i), b(i) ] in window---and is SPICEFALSE
   otherwise.
 

Parameters

 
   None. 
 

Exceptions

 
   1) If the input window is a SpiceCell of type other than double 
      precision, the error SPICE(TYPEMISMATCH) is signaled.
 

Files

 
   None. 
 

Particulars

 
   None. 
 

Examples

 
   Let window contain the intervals 

      [ 1, 3 ]  [ 7, 11 ]  [ 23, 27 ] 

   Then the following expressions are SPICETRUE 

      wnincd_c ( 1.0,  3.0, &window );
      wnincd_c ( 9.0, 10.0, &window );

   and the following expressions are SPICEFALSE. 

      wnincd_c (  0.0,  2.0, &window ); 
      wnincd_c ( 13.0, 15.0, &window ); 
      wnincd_c ( 29.0, 30.0, &window );
 

Restrictions

 
   None. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman    (JPL)
   H.A. Neilan     (JPL) 
   W.L. Taber      (JPL) 
   I.M. Underwood  (JPL) 
 

Version

 
   -CSPICE Version 1.0.0, 29-JUL-2002 (NJB) (HAN) (WLT) (IMU)

Index_Entries

 
   included in a d.p. window 
 

Link to routine wnincd_c source file wnincd_c.c