 
 
 
 
 
 
 
  
 Next: Matrix and Matrix Sequence
 Up: Some Functions and Methods
 Previous: Time Object Handling
     Contents 
In the examples below ti is an object of type TimeInterval. Since QdTimeInterval inherits
from this class the methods described all work for QdTimeInterval_var pointers. For example
TimeInterval ti=new TimeInterval(Time(2000,1,2,12.0), 
                                 Time(2000,1,2,14.0));
Time t = ti.end();
becomes the QdObject method
QdTimeInterval_var ti=new QdTimeInterval(QdTime(2000,1,2,12.0), 
                                         QdTime(2000,1,2,14.0));
QdTime_var t = new QdTime(ti->end());
  
- bool contains( Time& t ), returns true if a time, t, is contained in the interval, e.g.- if(ti.contains(t)){...}
 
  
- void display(), will print a text representation of the interval to stdout, 
   e.g.- ti.display()
  
- Time duration(), returns a signed Time object holding the duration of ti, e.g.
 -  Time t1 = ti.duration()
  
- Time duration_abs(), returns a Time object holding the absolute duration of ti, e.g.-  t1 = ti.duration_abs()
  
- bool empty(), returns true when duration=0, e.g.- if(ti.empty()){...}
  
- Time end(), returns a Time object holding the end time of ti, e.g.- t1=ti.end()
  
- Time end_abs(),  returns a Time object holding the later time of ti, e.g.- t1=ti.end_abs().
  
- void force_sense(Sense option=TIME_SENSE_POSITIVE ),
 forces the sense of ti to be either TIME_SENSE_POSITIVE or TIME_SENSE_NEGATIVE. The
     default is TIME_SENSE_POSITIVE,
      e.g.- ti.force_sense(TIME_SENSE_POSITIVE)which is equivalent to- ti.force_sense()
  
- int get_sense(), returns TIME_SENSE of ti,  e.g.- ti.get_sense()Possible return values are, NO_TIME_SENSE, TIME_SENSE_POSITIVE, TIME_SENSE_NEGATIVE.
  
- TimeInterval int_intersect(TimeInterval& ti), returns a TimeInterval
     containing the intersection of t1 and t2, e.g.- ti=t1.int_intersect(t2)
 
  
- TimeInterval int_union(TimeInterval& ti), e.g.- ti=t1.int_union(t2)
 returns union of t1 and t2.
  
- void reverse(), e.g.- t1.reverse()reverses sense of t1.
  
- void set( Time& st,  Time& ed, Sense option=NO_TIME_SENSE),
 e.g.- ti.set(t1,t2)sets ti from start time t1 and end time t2.
  
- void set_duration(Time& d, SetOption option=SAME_START_TIME),
 e.g.- ti.set_duration(td,SAME_START_TIME)sets end time of ti to- ti.start()+td.
  
- void set_duration( Time& t,  Time& d, SetOption option=START_TIME),
 e.g.- ti.set_duration(t1,td,START_TIME)sets ti from t1 and- t1+td.
  
- void set_end( Time& ed, SetOption option=SAME_START_TIME ),
 e.g.- ti.set_end(t1)sets end time of ti.
  
- void set_start( Time& ed, SetOption option=SAME_SEND_TIME ),
 e.g.- ti.set_start(t1)sets start time of ti.
  
- void shift_forward(double factor = 1.0 ), e.g.- ti.shift_forward(0.5)
 shifts ti forward by-  0.5 * ti.duration(), that is it shifts the
      time interval forward by half its own duration. The default is to shift
      the interval forwards by its own duration.
  
- void shift_back(double factor = 1.0 ), e.g.- ti.shift_back(2.0)
 shifts ti backward by-  2.0 * ti.duration(). The default is to shift
      the interval by its own duration.
  
- Time start(), e.g.- t1=ti.start()returns start time.
  
- Time end(), e.g.- t1=ti.end()returns end time.- 
 
 
 
 
 
 
 
 
  
 Next: Matrix and Matrix Sequence
 Up: Some Functions and Methods
 Previous: Time Object Handling
     Contents 
Anthony Allen
2005-11-07