php_library/general/puts.inc

<?php
if (!isset($GENERAL_TIMERAW_INCLUDED))
   {
   include("general/timeraw.inc");
   $GENERAL_TIMERAW_INCLUDED=1;
   }
?>
<?php
//********************************************************************************
//Copyright (C) 2006 David T. Ashley
//********************************************************************************
//This program or source file 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 program or source file is distributed in the hope that it will 
//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//GNU General Public License for more details.
//
//You may have received a copy of the GNU General Public License
//along with this program; if not, write to the Free Software
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//********************************************************************************
//Dave Ashley, 01/06
//
//This source file provides the code to create process-unique
//timestamps.  A process-unique timestamp is guaranteed to be unique
//because this code will spin-lock until the time changes.
//
//A process-unique timestamp is 72 bits of information (18 hexadecimal
//digits).  The breakdown is:
//
//   a)First 40 bits (10 hexadecimal digits).  The integer time, in seconds
//     since the Unix epoch.  The extra 8 bits are reserved due to the impending
//     Unix 2037 AD issue.
//
//   b)Second 32 bits (8 hexadecimal digits).  The nanoseconds representing the 
//     fractional part of the integer seconds.
//
//Note that both of the data sizes above are designed to allow future
//expansion.  The integer part is designed for the Unix 2037 issue.  The
//fractional part is designed for faster hardware in the future.
//
//
function PUTS_timestamp()
   {
   //Obtain the initial value.
   $rv = TIMERAW_time_precision_hex();

   //Wait for the time to change.  Although I don't think it would make a difference
   //in practice, there is sleep to be more efficient.
   $new_time = TIMERAW_time_precision_hex();
   if ($rv == $new_time)
      {
      do
         {
         usleep(100);
         $new_time = TIMERAW_time_precision_hex();
         }
      while ($rv == $new_time);
      }

   //The time has changed.  We are clear to return.
   return($rv);
   }
//
//
//Returns the size (in chars) of a process-unique timestamp.
//
function PUTS_timestamp_size()
   {
   return(TIMERAW_time_precision_hex_size());
   }
?>
1	dashley	35	<?php
2			if (!isset($GENERAL_TIMERAW_INCLUDED))
3			{
4			include("general/timeraw.inc");
5			$GENERAL_TIMERAW_INCLUDED=1;
6			}
7			?>
8			<?php
9			//********************************************************************************
10			//Copyright (C) 2006 David T. Ashley
11			//********************************************************************************
12			//This program or source file is free software; you can redistribute it and/or
13			//modify it under the terms of the GNU General Public License as published by
14			//the Free Software Foundation; either version 2 of the License, or (at your
15			//option) any later version.
16			//
17			//This program or source file is distributed in the hope that it will
18			//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
19			//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20			//GNU General Public License for more details.
21			//
22			//You may have received a copy of the GNU General Public License
23			//along with this program; if not, write to the Free Software
24			//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25			//********************************************************************************
26			//Dave Ashley, 01/06
27			//
28			//This source file provides the code to create process-unique
29			//timestamps. A process-unique timestamp is guaranteed to be unique
30			//because this code will spin-lock until the time changes.
31			//
32			//A process-unique timestamp is 72 bits of information (18 hexadecimal
33			//digits). The breakdown is:
34			//
35			// a)First 40 bits (10 hexadecimal digits). The integer time, in seconds
36			// since the Unix epoch. The extra 8 bits are reserved due to the impending
37			// Unix 2037 AD issue.
38			//
39			// b)Second 32 bits (8 hexadecimal digits). The nanoseconds representing the
40			// fractional part of the integer seconds.
41			//
42			//Note that both of the data sizes above are designed to allow future
43			//expansion. The integer part is designed for the Unix 2037 issue. The
44			//fractional part is designed for faster hardware in the future.
45			//
46			//
47			function PUTS_timestamp()
48			{
49			//Obtain the initial value.
50			$rv = TIMERAW_time_precision_hex();
51
52			//Wait for the time to change. Although I don't think it would make a difference
53			//in practice, there is sleep to be more efficient.
54			$new_time = TIMERAW_time_precision_hex();
55			if ($rv == $new_time)
56			{
57			do
58			{
59			usleep(100);
60			$new_time = TIMERAW_time_precision_hex();
61			}
62			while ($rv == $new_time);
63			}
64
65			//The time has changed. We are clear to return.
66			return($rv);
67			}
68			//
69			//
70			//Returns the size (in chars) of a process-unique timestamp.
71			//
72			function PUTS_timestamp_size()
73			{
74			return(TIMERAW_time_precision_hex_size());
75			}
76			?>