file_time.h

Go to the documentation of this file.

#ifndef FILE_TIME_CLASS
#define FILE_TIME_CLASS
 
/*****************************************************************************\
*                                                                             *
*  Name   : file_time                                                         *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 1992-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/
 
 
#include <basis/astring.h>
#include <basis/byte_array.h>
#include <basis/contracts.h>
 
#include <stdio.h>
#include <time.h>
 
namespace filesystem {
 
class file_time
: public virtual basis::hoople_standard,
  public virtual basis::orderable
{
public:
  file_time();  
 
  file_time(FILE *the_FILE);
 
  file_time(const basis::astring &filename);
 
  file_time(const time_t &init);
 
//hmmm: need a converter that sucks in an earth_time time_locus object.
 
  virtual ~file_time();
 
  DEFINE_CLASS_NAME("file_time");
 
  virtual void text_form(basis::base_string &time_string) const;
 
  virtual void readable_text_form(basis::base_string &time_string) const;
 
  void reset(FILE *the_FILE);
 
  void reset(const basis::astring &filename);
 
  void reset(const time_t &init);
 
  time_t raw() const { return _when; }
 
  bool set_time(const basis::astring &filename);
 
  // Standard comparison operators between this file time and the file time
  // "ft2".  These are meaningless if either time is invalid.
  virtual bool less_than(const basis::orderable &ft2) const;
  virtual bool equal_to(const basis::equalizable &ft2) const;
 
  // supports streaming the time into and out of a byte array.
  virtual int packed_size() const;
  virtual void pack(basis::byte_array &packed_form) const;
  virtual bool unpack(basis::byte_array &packed_form);
 
private:
  time_t _when;  
 
  int compare(const file_time &ft2) const;
};
 
} //namespace.
 
#endif