mirror of
				https://github.com/python/cpython.git
				synced 2025-10-30 21:21:22 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			1599 lines
		
	
	
	
		
			45 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			1599 lines
		
	
	
	
		
			45 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* Time module */
 | |
| 
 | |
| #include "Python.h"
 | |
| 
 | |
| #include <ctype.h>
 | |
| 
 | |
| #ifdef HAVE_SYS_TIMES_H
 | |
| #include <sys/times.h>
 | |
| #endif
 | |
| 
 | |
| #ifdef HAVE_SYS_TYPES_H
 | |
| #include <sys/types.h>
 | |
| #endif
 | |
| 
 | |
| #if defined(HAVE_SYS_RESOURCE_H)
 | |
| #include <sys/resource.h>
 | |
| #endif
 | |
| 
 | |
| #ifdef QUICKWIN
 | |
| #include <io.h>
 | |
| #endif
 | |
| 
 | |
| #if defined(__WATCOMC__) && !defined(__QNX__)
 | |
| #include <i86.h>
 | |
| #else
 | |
| #ifdef MS_WINDOWS
 | |
| #define WIN32_LEAN_AND_MEAN
 | |
| #include <windows.h>
 | |
| #include "pythread.h"
 | |
| 
 | |
| #if defined(__BORLANDC__)
 | |
| /* These overrides not needed for Win32 */
 | |
| #define timezone _timezone
 | |
| #define tzname _tzname
 | |
| #define daylight _daylight
 | |
| #endif /* __BORLANDC__ */
 | |
| #endif /* MS_WINDOWS */
 | |
| #endif /* !__WATCOMC__ || __QNX__ */
 | |
| 
 | |
| #if defined(__APPLE__)
 | |
| #include <mach/mach_time.h>
 | |
| #endif
 | |
| 
 | |
| /* Forward declarations */
 | |
| static int floatsleep(double);
 | |
| static PyObject* floattime(_Py_clock_info_t *info);
 | |
| 
 | |
| #ifdef MS_WINDOWS
 | |
| static OSVERSIONINFOEX winver;
 | |
| #endif
 | |
| 
 | |
| static PyObject *
 | |
| time_time(PyObject *self, PyObject *unused)
 | |
| {
 | |
|     return floattime(NULL);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(time_doc,
 | |
| "time() -> floating point number\n\
 | |
| \n\
 | |
| Return the current time in seconds since the Epoch.\n\
 | |
| Fractions of a second may be present if the system clock provides them.");
 | |
| 
 | |
| #if defined(HAVE_CLOCK)
 | |
| 
 | |
| #ifndef CLOCKS_PER_SEC
 | |
| #ifdef CLK_TCK
 | |
| #define CLOCKS_PER_SEC CLK_TCK
 | |
| #else
 | |
| #define CLOCKS_PER_SEC 1000000
 | |
| #endif
 | |
| #endif
 | |
| 
 | |
| static PyObject *
 | |
| floatclock(_Py_clock_info_t *info)
 | |
| {
 | |
|     clock_t value;
 | |
|     value = clock();
 | |
|     if (value == (clock_t)-1) {
 | |
|         PyErr_SetString(PyExc_RuntimeError,
 | |
|                 "the processor time used is not available "
 | |
|                 "or its value cannot be represented");
 | |
|         return NULL;
 | |
|     }
 | |
|     if (info) {
 | |
|         info->implementation = "clock()";
 | |
|         info->resolution = 1.0 / (double)CLOCKS_PER_SEC;
 | |
|         info->monotonic = 1;
 | |
|         info->adjustable = 0;
 | |
|     }
 | |
|     return PyFloat_FromDouble((double)value / CLOCKS_PER_SEC);
 | |
| }
 | |
| #endif /* HAVE_CLOCK */
 | |
| 
 | |
| #if defined(MS_WINDOWS) && !defined(__BORLANDC__)
 | |
| #define WIN32_PERF_COUNTER
 | |
| /* Win32 has better clock replacement; we have our own version, due to Mark
 | |
|    Hammond and Tim Peters */
 | |
| static int
 | |
| win_perf_counter(_Py_clock_info_t *info, PyObject **result)
 | |
| {
 | |
|     static LONGLONG cpu_frequency = 0;
 | |
|     static LONGLONG ctrStart;
 | |
|     LARGE_INTEGER now;
 | |
|     double diff;
 | |
| 
 | |
|     if (cpu_frequency == 0) {
 | |
|         LARGE_INTEGER freq;
 | |
|         QueryPerformanceCounter(&now);
 | |
|         ctrStart = now.QuadPart;
 | |
|         if (!QueryPerformanceFrequency(&freq) || freq.QuadPart == 0) {
 | |
|             /* Unlikely to happen - this works on all intel
 | |
|                machines at least!  Revert to clock() */
 | |
|             *result = NULL;
 | |
|             return -1;
 | |
|         }
 | |
|         cpu_frequency = freq.QuadPart;
 | |
|     }
 | |
|     QueryPerformanceCounter(&now);
 | |
|     diff = (double)(now.QuadPart - ctrStart);
 | |
|     if (info) {
 | |
|         info->implementation = "QueryPerformanceCounter()";
 | |
|         info->resolution = 1.0 / (double)cpu_frequency;
 | |
|         info->monotonic = 1;
 | |
|         info->adjustable = 0;
 | |
|     }
 | |
|     *result = PyFloat_FromDouble(diff / (double)cpu_frequency);
 | |
|     return 0;
 | |
| }
 | |
| #endif
 | |
| 
 | |
| #if defined(WIN32_PERF_COUNTER) || defined(HAVE_CLOCK)
 | |
| #define PYCLOCK
 | |
| static PyObject*
 | |
| pyclock(_Py_clock_info_t *info)
 | |
| {
 | |
| #ifdef WIN32_PERF_COUNTER
 | |
|     PyObject *res;
 | |
|     if (win_perf_counter(info, &res) == 0)
 | |
|         return res;
 | |
| #endif
 | |
|     return floatclock(info);
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_clock(PyObject *self, PyObject *unused)
 | |
| {
 | |
|     return pyclock(NULL);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(clock_doc,
 | |
| "clock() -> floating point number\n\
 | |
| \n\
 | |
| Return the CPU time or real time since the start of the process or since\n\
 | |
| the first call to clock().  This has as much precision as the system\n\
 | |
| records.");
 | |
| #endif
 | |
| 
 | |
| #ifdef HAVE_CLOCK_GETTIME
 | |
| static PyObject *
 | |
| time_clock_gettime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     int ret;
 | |
|     int clk_id;
 | |
|     struct timespec tp;
 | |
| 
 | |
|     if (!PyArg_ParseTuple(args, "i:clock_gettime", &clk_id))
 | |
|         return NULL;
 | |
| 
 | |
|     ret = clock_gettime((clockid_t)clk_id, &tp);
 | |
|     if (ret != 0) {
 | |
|         PyErr_SetFromErrno(PyExc_IOError);
 | |
|         return NULL;
 | |
|     }
 | |
|     return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(clock_gettime_doc,
 | |
| "clock_gettime(clk_id) -> floating point number\n\
 | |
| \n\
 | |
| Return the time of the specified clock clk_id.");
 | |
| 
 | |
| static PyObject *
 | |
| time_clock_settime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     int clk_id;
 | |
|     PyObject *obj;
 | |
|     time_t tv_sec;
 | |
|     long tv_nsec;
 | |
|     struct timespec tp;
 | |
|     int ret;
 | |
| 
 | |
|     if (!PyArg_ParseTuple(args, "iO:clock_settime", &clk_id, &obj))
 | |
|         return NULL;
 | |
| 
 | |
|     if (_PyTime_ObjectToTimespec(obj, &tv_sec, &tv_nsec) == -1)
 | |
|         return NULL;
 | |
|     tp.tv_sec = tv_sec;
 | |
|     tp.tv_nsec = tv_nsec;
 | |
| 
 | |
|     ret = clock_settime((clockid_t)clk_id, &tp);
 | |
|     if (ret != 0) {
 | |
|         PyErr_SetFromErrno(PyExc_IOError);
 | |
|         return NULL;
 | |
|     }
 | |
|     Py_RETURN_NONE;
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(clock_settime_doc,
 | |
| "clock_settime(clk_id, time)\n\
 | |
| \n\
 | |
| Set the time of the specified clock clk_id.");
 | |
| 
 | |
| static PyObject *
 | |
| time_clock_getres(PyObject *self, PyObject *args)
 | |
| {
 | |
|     int ret;
 | |
|     int clk_id;
 | |
|     struct timespec tp;
 | |
| 
 | |
|     if (!PyArg_ParseTuple(args, "i:clock_getres", &clk_id))
 | |
|         return NULL;
 | |
| 
 | |
|     ret = clock_getres((clockid_t)clk_id, &tp);
 | |
|     if (ret != 0) {
 | |
|         PyErr_SetFromErrno(PyExc_IOError);
 | |
|         return NULL;
 | |
|     }
 | |
| 
 | |
|     return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(clock_getres_doc,
 | |
| "clock_getres(clk_id) -> floating point number\n\
 | |
| \n\
 | |
| Return the resolution (precision) of the specified clock clk_id.");
 | |
| #endif   /* HAVE_CLOCK_GETTIME */
 | |
| 
 | |
| static PyObject *
 | |
| time_sleep(PyObject *self, PyObject *args)
 | |
| {
 | |
|     double secs;
 | |
|     if (!PyArg_ParseTuple(args, "d:sleep", &secs))
 | |
|         return NULL;
 | |
|     if (secs < 0) {
 | |
|         PyErr_SetString(PyExc_ValueError,
 | |
|                         "sleep length must be non-negative");
 | |
|         return NULL;
 | |
|     }
 | |
|     if (floatsleep(secs) != 0)
 | |
|         return NULL;
 | |
|     Py_INCREF(Py_None);
 | |
|     return Py_None;
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(sleep_doc,
 | |
| "sleep(seconds)\n\
 | |
| \n\
 | |
| Delay execution for a given number of seconds.  The argument may be\n\
 | |
| a floating point number for subsecond precision.");
 | |
| 
 | |
| static PyStructSequence_Field struct_time_type_fields[] = {
 | |
|     {"tm_year", "year, for example, 1993"},
 | |
|     {"tm_mon", "month of year, range [1, 12]"},
 | |
|     {"tm_mday", "day of month, range [1, 31]"},
 | |
|     {"tm_hour", "hours, range [0, 23]"},
 | |
|     {"tm_min", "minutes, range [0, 59]"},
 | |
|     {"tm_sec", "seconds, range [0, 61])"},
 | |
|     {"tm_wday", "day of week, range [0, 6], Monday is 0"},
 | |
|     {"tm_yday", "day of year, range [1, 366]"},
 | |
|     {"tm_isdst", "1 if summer time is in effect, 0 if not, and -1 if unknown"},
 | |
| #ifdef HAVE_STRUCT_TM_TM_ZONE
 | |
|     {"tm_zone", "abbreviation of timezone name"},
 | |
|     {"tm_gmtoff", "offset from UTC in seconds"},
 | |
| #endif /* HAVE_STRUCT_TM_TM_ZONE */
 | |
|     {0}
 | |
| };
 | |
| 
 | |
| static PyStructSequence_Desc struct_time_type_desc = {
 | |
|     "time.struct_time",
 | |
|     "The time value as returned by gmtime(), localtime(), and strptime(), and\n"
 | |
|     " accepted by asctime(), mktime() and strftime().  May be considered as a\n"
 | |
|     " sequence of 9 integers.\n\n"
 | |
|     " Note that several fields' values are not the same as those defined by\n"
 | |
|     " the C language standard for struct tm.  For example, the value of the\n"
 | |
|     " field tm_year is the actual year, not year - 1900.  See individual\n"
 | |
|     " fields' descriptions for details.",
 | |
|     struct_time_type_fields,
 | |
|     9,
 | |
| };
 | |
| 
 | |
| static int initialized;
 | |
| static PyTypeObject StructTimeType;
 | |
| 
 | |
| 
 | |
| static PyObject *
 | |
| tmtotuple(struct tm *p)
 | |
| {
 | |
|     PyObject *v = PyStructSequence_New(&StructTimeType);
 | |
|     if (v == NULL)
 | |
|         return NULL;
 | |
| 
 | |
| #define SET(i,val) PyStructSequence_SET_ITEM(v, i, PyLong_FromLong((long) val))
 | |
| 
 | |
|     SET(0, p->tm_year + 1900);
 | |
|     SET(1, p->tm_mon + 1);         /* Want January == 1 */
 | |
|     SET(2, p->tm_mday);
 | |
|     SET(3, p->tm_hour);
 | |
|     SET(4, p->tm_min);
 | |
|     SET(5, p->tm_sec);
 | |
|     SET(6, (p->tm_wday + 6) % 7); /* Want Monday == 0 */
 | |
|     SET(7, p->tm_yday + 1);        /* Want January, 1 == 1 */
 | |
|     SET(8, p->tm_isdst);
 | |
| #ifdef HAVE_STRUCT_TM_TM_ZONE
 | |
|     PyStructSequence_SET_ITEM(v, 9,
 | |
|         PyUnicode_DecodeLocale(p->tm_zone, "surrogateescape"));
 | |
|     SET(10, p->tm_gmtoff);
 | |
| #endif /* HAVE_STRUCT_TM_TM_ZONE */
 | |
| #undef SET
 | |
|     if (PyErr_Occurred()) {
 | |
|         Py_XDECREF(v);
 | |
|         return NULL;
 | |
|     }
 | |
| 
 | |
|     return v;
 | |
| }
 | |
| 
 | |
| /* Parse arg tuple that can contain an optional float-or-None value;
 | |
|    format needs to be "|O:name".
 | |
|    Returns non-zero on success (parallels PyArg_ParseTuple).
 | |
| */
 | |
| static int
 | |
| parse_time_t_args(PyObject *args, char *format, time_t *pwhen)
 | |
| {
 | |
|     PyObject *ot = NULL;
 | |
|     time_t whent;
 | |
| 
 | |
|     if (!PyArg_ParseTuple(args, format, &ot))
 | |
|         return 0;
 | |
|     if (ot == NULL || ot == Py_None) {
 | |
|         whent = time(NULL);
 | |
|     }
 | |
|     else {
 | |
|         if (_PyTime_ObjectToTime_t(ot, &whent) == -1)
 | |
|             return 0;
 | |
|     }
 | |
|     *pwhen = whent;
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_gmtime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     time_t when;
 | |
|     struct tm buf, *local;
 | |
| 
 | |
|     if (!parse_time_t_args(args, "|O:gmtime", &when))
 | |
|         return NULL;
 | |
| 
 | |
|     errno = 0;
 | |
|     local = gmtime(&when);
 | |
|     if (local == NULL) {
 | |
| #ifdef EINVAL
 | |
|         if (errno == 0)
 | |
|             errno = EINVAL;
 | |
| #endif
 | |
|         return PyErr_SetFromErrno(PyExc_OSError);
 | |
|     }
 | |
|     buf = *local;
 | |
|     return tmtotuple(&buf);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(gmtime_doc,
 | |
| "gmtime([seconds]) -> (tm_year, tm_mon, tm_mday, tm_hour, tm_min,\n\
 | |
|                        tm_sec, tm_wday, tm_yday, tm_isdst)\n\
 | |
| \n\
 | |
| Convert seconds since the Epoch to a time tuple expressing UTC (a.k.a.\n\
 | |
| GMT).  When 'seconds' is not passed in, convert the current time instead.\n\
 | |
| \n\
 | |
| If the platform supports the tm_gmtoff and tm_zone, they are available as\n\
 | |
| attributes only.");
 | |
| 
 | |
| static int
 | |
| pylocaltime(time_t *timep, struct tm *result)
 | |
| {
 | |
|     struct tm *local;
 | |
| 
 | |
|     assert (timep != NULL);
 | |
|     local = localtime(timep);
 | |
|     if (local == NULL) {
 | |
|         /* unconvertible time */
 | |
| #ifdef EINVAL
 | |
|         if (errno == 0)
 | |
|             errno = EINVAL;
 | |
| #endif
 | |
|         PyErr_SetFromErrno(PyExc_OSError);
 | |
|         return -1;
 | |
|     }
 | |
|     *result = *local;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_localtime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     time_t when;
 | |
|     struct tm buf;
 | |
| 
 | |
|     if (!parse_time_t_args(args, "|O:localtime", &when))
 | |
|         return NULL;
 | |
|     if (pylocaltime(&when, &buf) == -1)
 | |
|         return NULL;
 | |
|     return tmtotuple(&buf);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(localtime_doc,
 | |
| "localtime([seconds]) -> (tm_year,tm_mon,tm_mday,tm_hour,tm_min,\n\
 | |
|                           tm_sec,tm_wday,tm_yday,tm_isdst)\n\
 | |
| \n\
 | |
| Convert seconds since the Epoch to a time tuple expressing local time.\n\
 | |
| When 'seconds' is not passed in, convert the current time instead.");
 | |
| 
 | |
| /* Convert 9-item tuple to tm structure.  Return 1 on success, set
 | |
|  * an exception and return 0 on error.
 | |
|  */
 | |
| static int
 | |
| gettmarg(PyObject *args, struct tm *p)
 | |
| {
 | |
|     int y;
 | |
| 
 | |
|     memset((void *) p, '\0', sizeof(struct tm));
 | |
| 
 | |
|     if (!PyTuple_Check(args)) {
 | |
|         PyErr_SetString(PyExc_TypeError,
 | |
|                         "Tuple or struct_time argument required");
 | |
|         return 0;
 | |
|     }
 | |
| 
 | |
|     if (!PyArg_ParseTuple(args, "iiiiiiiii",
 | |
|                           &y, &p->tm_mon, &p->tm_mday,
 | |
|                           &p->tm_hour, &p->tm_min, &p->tm_sec,
 | |
|                           &p->tm_wday, &p->tm_yday, &p->tm_isdst))
 | |
|         return 0;
 | |
|     p->tm_year = y - 1900;
 | |
|     p->tm_mon--;
 | |
|     p->tm_wday = (p->tm_wday + 1) % 7;
 | |
|     p->tm_yday--;
 | |
| #ifdef HAVE_STRUCT_TM_TM_ZONE
 | |
|     if (Py_TYPE(args) == &StructTimeType) {
 | |
|         PyObject *item;
 | |
|         item = PyTuple_GET_ITEM(args, 9);
 | |
|         p->tm_zone = item == Py_None ? NULL : _PyUnicode_AsString(item);
 | |
|         item = PyTuple_GET_ITEM(args, 10);
 | |
|         p->tm_gmtoff = item == Py_None ? 0 : PyLong_AsLong(item);
 | |
|         if (PyErr_Occurred())
 | |
|             return 0;
 | |
|     }
 | |
| #endif /* HAVE_STRUCT_TM_TM_ZONE */
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| /* Check values of the struct tm fields before it is passed to strftime() and
 | |
|  * asctime().  Return 1 if all values are valid, otherwise set an exception
 | |
|  * and returns 0.
 | |
|  */
 | |
| static int
 | |
| checktm(struct tm* buf)
 | |
| {
 | |
|     /* Checks added to make sure strftime() and asctime() does not crash Python by
 | |
|        indexing blindly into some array for a textual representation
 | |
|        by some bad index (fixes bug #897625 and #6608).
 | |
| 
 | |
|        Also support values of zero from Python code for arguments in which
 | |
|        that is out of range by forcing that value to the lowest value that
 | |
|        is valid (fixed bug #1520914).
 | |
| 
 | |
|        Valid ranges based on what is allowed in struct tm:
 | |
| 
 | |
|        - tm_year: [0, max(int)] (1)
 | |
|        - tm_mon: [0, 11] (2)
 | |
|        - tm_mday: [1, 31]
 | |
|        - tm_hour: [0, 23]
 | |
|        - tm_min: [0, 59]
 | |
|        - tm_sec: [0, 60]
 | |
|        - tm_wday: [0, 6] (1)
 | |
|        - tm_yday: [0, 365] (2)
 | |
|        - tm_isdst: [-max(int), max(int)]
 | |
| 
 | |
|        (1) gettmarg() handles bounds-checking.
 | |
|        (2) Python's acceptable range is one greater than the range in C,
 | |
|        thus need to check against automatic decrement by gettmarg().
 | |
|     */
 | |
|     if (buf->tm_mon == -1)
 | |
|         buf->tm_mon = 0;
 | |
|     else if (buf->tm_mon < 0 || buf->tm_mon > 11) {
 | |
|         PyErr_SetString(PyExc_ValueError, "month out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     if (buf->tm_mday == 0)
 | |
|         buf->tm_mday = 1;
 | |
|     else if (buf->tm_mday < 0 || buf->tm_mday > 31) {
 | |
|         PyErr_SetString(PyExc_ValueError, "day of month out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     if (buf->tm_hour < 0 || buf->tm_hour > 23) {
 | |
|         PyErr_SetString(PyExc_ValueError, "hour out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     if (buf->tm_min < 0 || buf->tm_min > 59) {
 | |
|         PyErr_SetString(PyExc_ValueError, "minute out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     if (buf->tm_sec < 0 || buf->tm_sec > 61) {
 | |
|         PyErr_SetString(PyExc_ValueError, "seconds out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     /* tm_wday does not need checking of its upper-bound since taking
 | |
|     ``% 7`` in gettmarg() automatically restricts the range. */
 | |
|     if (buf->tm_wday < 0) {
 | |
|         PyErr_SetString(PyExc_ValueError, "day of week out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     if (buf->tm_yday == -1)
 | |
|         buf->tm_yday = 0;
 | |
|     else if (buf->tm_yday < 0 || buf->tm_yday > 365) {
 | |
|         PyErr_SetString(PyExc_ValueError, "day of year out of range");
 | |
|         return 0;
 | |
|     }
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| #ifdef MS_WINDOWS
 | |
|    /* wcsftime() doesn't format correctly time zones, see issue #10653 */
 | |
| #  undef HAVE_WCSFTIME
 | |
| #endif
 | |
| #define STRFTIME_FORMAT_CODES \
 | |
| "Commonly used format codes:\n\
 | |
| \n\
 | |
| %Y  Year with century as a decimal number.\n\
 | |
| %m  Month as a decimal number [01,12].\n\
 | |
| %d  Day of the month as a decimal number [01,31].\n\
 | |
| %H  Hour (24-hour clock) as a decimal number [00,23].\n\
 | |
| %M  Minute as a decimal number [00,59].\n\
 | |
| %S  Second as a decimal number [00,61].\n\
 | |
| %z  Time zone offset from UTC.\n\
 | |
| %a  Locale's abbreviated weekday name.\n\
 | |
| %A  Locale's full weekday name.\n\
 | |
| %b  Locale's abbreviated month name.\n\
 | |
| %B  Locale's full month name.\n\
 | |
| %c  Locale's appropriate date and time representation.\n\
 | |
| %I  Hour (12-hour clock) as a decimal number [01,12].\n\
 | |
| %p  Locale's equivalent of either AM or PM.\n\
 | |
| \n\
 | |
| Other codes may be available on your platform.  See documentation for\n\
 | |
| the C library strftime function.\n"
 | |
| 
 | |
| #ifdef HAVE_STRFTIME
 | |
| #ifdef HAVE_WCSFTIME
 | |
| #define time_char wchar_t
 | |
| #define format_time wcsftime
 | |
| #define time_strlen wcslen
 | |
| #else
 | |
| #define time_char char
 | |
| #define format_time strftime
 | |
| #define time_strlen strlen
 | |
| #endif
 | |
| 
 | |
| static PyObject *
 | |
| time_strftime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     PyObject *tup = NULL;
 | |
|     struct tm buf;
 | |
|     const time_char *fmt;
 | |
| #ifdef HAVE_WCSFTIME
 | |
|     wchar_t *format;
 | |
| #else
 | |
|     PyObject *format;
 | |
| #endif
 | |
|     PyObject *format_arg;
 | |
|     size_t fmtlen, buflen;
 | |
|     time_char *outbuf = NULL;
 | |
|     size_t i;
 | |
|     PyObject *ret = NULL;
 | |
| 
 | |
|     memset((void *) &buf, '\0', sizeof(buf));
 | |
| 
 | |
|     /* Will always expect a unicode string to be passed as format.
 | |
|        Given that there's no str type anymore in py3k this seems safe.
 | |
|     */
 | |
|     if (!PyArg_ParseTuple(args, "U|O:strftime", &format_arg, &tup))
 | |
|         return NULL;
 | |
| 
 | |
|     if (tup == NULL) {
 | |
|         time_t tt = time(NULL);
 | |
|         if (pylocaltime(&tt, &buf) == -1)
 | |
|             return NULL;
 | |
|     }
 | |
|     else if (!gettmarg(tup, &buf) || !checktm(&buf))
 | |
|         return NULL;
 | |
| 
 | |
| #if defined(_MSC_VER) || defined(sun)
 | |
|     if (buf.tm_year + 1900 < 1 || 9999 < buf.tm_year + 1900) {
 | |
|         PyErr_SetString(PyExc_ValueError,
 | |
|                         "strftime() requires year in [1; 9999]");
 | |
|         return NULL;
 | |
|     }
 | |
| #endif
 | |
| 
 | |
|     /* Normalize tm_isdst just in case someone foolishly implements %Z
 | |
|        based on the assumption that tm_isdst falls within the range of
 | |
|        [-1, 1] */
 | |
|     if (buf.tm_isdst < -1)
 | |
|         buf.tm_isdst = -1;
 | |
|     else if (buf.tm_isdst > 1)
 | |
|         buf.tm_isdst = 1;
 | |
| 
 | |
| #ifdef HAVE_WCSFTIME
 | |
|     format = PyUnicode_AsWideCharString(format_arg, NULL);
 | |
|     if (format == NULL)
 | |
|         return NULL;
 | |
|     fmt = format;
 | |
| #else
 | |
|     /* Convert the unicode string to an ascii one */
 | |
|     format = PyUnicode_EncodeLocale(format_arg, "surrogateescape");
 | |
|     if (format == NULL)
 | |
|         return NULL;
 | |
|     fmt = PyBytes_AS_STRING(format);
 | |
| #endif
 | |
| 
 | |
| #if defined(MS_WINDOWS) && !defined(HAVE_WCSFTIME)
 | |
|     /* check that the format string contains only valid directives */
 | |
|     for(outbuf = strchr(fmt, '%');
 | |
|         outbuf != NULL;
 | |
|         outbuf = strchr(outbuf+2, '%'))
 | |
|     {
 | |
|         if (outbuf[1]=='#')
 | |
|             ++outbuf; /* not documented by python, */
 | |
|         if (outbuf[1]=='\0' ||
 | |
|             !strchr("aAbBcdHIjmMpSUwWxXyYzZ%", outbuf[1]))
 | |
|         {
 | |
|             PyErr_SetString(PyExc_ValueError, "Invalid format string");
 | |
|             Py_DECREF(format);
 | |
|             return NULL;
 | |
|         }
 | |
|     }
 | |
| #endif
 | |
| 
 | |
|     fmtlen = time_strlen(fmt);
 | |
| 
 | |
|     /* I hate these functions that presume you know how big the output
 | |
|      * will be ahead of time...
 | |
|      */
 | |
|     for (i = 1024; ; i += i) {
 | |
| #if defined _MSC_VER && _MSC_VER >= 1400 && defined(__STDC_SECURE_LIB__)
 | |
|         int err;
 | |
| #endif
 | |
|         outbuf = (time_char *)PyMem_Malloc(i*sizeof(time_char));
 | |
|         if (outbuf == NULL) {
 | |
|             PyErr_NoMemory();
 | |
|             break;
 | |
|         }
 | |
|         buflen = format_time(outbuf, i, fmt, &buf);
 | |
| #if defined _MSC_VER && _MSC_VER >= 1400 && defined(__STDC_SECURE_LIB__)
 | |
|         err = errno;
 | |
| #endif
 | |
|         if (buflen > 0 || i >= 256 * fmtlen) {
 | |
|             /* If the buffer is 256 times as long as the format,
 | |
|                it's probably not failing for lack of room!
 | |
|                More likely, the format yields an empty result,
 | |
|                e.g. an empty format, or %Z when the timezone
 | |
|                is unknown. */
 | |
| #ifdef HAVE_WCSFTIME
 | |
|             ret = PyUnicode_FromWideChar(outbuf, buflen);
 | |
| #else
 | |
|             ret = PyUnicode_DecodeLocaleAndSize(outbuf, buflen,
 | |
|                                                 "surrogateescape");
 | |
| #endif
 | |
|             PyMem_Free(outbuf);
 | |
|             break;
 | |
|         }
 | |
|         PyMem_Free(outbuf);
 | |
| #if defined _MSC_VER && _MSC_VER >= 1400 && defined(__STDC_SECURE_LIB__)
 | |
|         /* VisualStudio .NET 2005 does this properly */
 | |
|         if (buflen == 0 && err == EINVAL) {
 | |
|             PyErr_SetString(PyExc_ValueError, "Invalid format string");
 | |
|             break;
 | |
|         }
 | |
| #endif
 | |
|     }
 | |
| #ifdef HAVE_WCSFTIME
 | |
|     PyMem_Free(format);
 | |
| #else
 | |
|     Py_DECREF(format);
 | |
| #endif
 | |
|     return ret;
 | |
| }
 | |
| 
 | |
| #undef time_char
 | |
| #undef format_time
 | |
| PyDoc_STRVAR(strftime_doc,
 | |
| "strftime(format[, tuple]) -> string\n\
 | |
| \n\
 | |
| Convert a time tuple to a string according to a format specification.\n\
 | |
| See the library reference manual for formatting codes. When the time tuple\n\
 | |
| is not present, current time as returned by localtime() is used.\n\
 | |
| \n" STRFTIME_FORMAT_CODES);
 | |
| #endif /* HAVE_STRFTIME */
 | |
| 
 | |
| static PyObject *
 | |
| time_strptime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     PyObject *strptime_module = PyImport_ImportModuleNoBlock("_strptime");
 | |
|     PyObject *strptime_result;
 | |
|     _Py_IDENTIFIER(_strptime_time);
 | |
| 
 | |
|     if (!strptime_module)
 | |
|         return NULL;
 | |
|     strptime_result = _PyObject_CallMethodId(strptime_module,
 | |
|                                              &PyId__strptime_time, "O", args);
 | |
|     Py_DECREF(strptime_module);
 | |
|     return strptime_result;
 | |
| }
 | |
| 
 | |
| 
 | |
| PyDoc_STRVAR(strptime_doc,
 | |
| "strptime(string, format) -> struct_time\n\
 | |
| \n\
 | |
| Parse a string to a time tuple according to a format specification.\n\
 | |
| See the library reference manual for formatting codes (same as\n\
 | |
| strftime()).\n\
 | |
| \n" STRFTIME_FORMAT_CODES);
 | |
| 
 | |
| static PyObject *
 | |
| _asctime(struct tm *timeptr)
 | |
| {
 | |
|     /* Inspired by Open Group reference implementation available at
 | |
|      * http://pubs.opengroup.org/onlinepubs/009695399/functions/asctime.html */
 | |
|     static char wday_name[7][4] = {
 | |
|         "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
 | |
|     };
 | |
|     static char mon_name[12][4] = {
 | |
|         "Jan", "Feb", "Mar", "Apr", "May", "Jun",
 | |
|         "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
 | |
|     };
 | |
|     return PyUnicode_FromFormat(
 | |
|         "%s %s%3d %.2d:%.2d:%.2d %d",
 | |
|         wday_name[timeptr->tm_wday],
 | |
|         mon_name[timeptr->tm_mon],
 | |
|         timeptr->tm_mday, timeptr->tm_hour,
 | |
|         timeptr->tm_min, timeptr->tm_sec,
 | |
|         1900 + timeptr->tm_year);
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_asctime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     PyObject *tup = NULL;
 | |
|     struct tm buf;
 | |
| 
 | |
|     if (!PyArg_UnpackTuple(args, "asctime", 0, 1, &tup))
 | |
|         return NULL;
 | |
|     if (tup == NULL) {
 | |
|         time_t tt = time(NULL);
 | |
|         if (pylocaltime(&tt, &buf) == -1)
 | |
|             return NULL;
 | |
| 
 | |
|     } else if (!gettmarg(tup, &buf) || !checktm(&buf))
 | |
|         return NULL;
 | |
|     return _asctime(&buf);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(asctime_doc,
 | |
| "asctime([tuple]) -> string\n\
 | |
| \n\
 | |
| Convert a time tuple to a string, e.g. 'Sat Jun 06 16:26:11 1998'.\n\
 | |
| When the time tuple is not present, current time as returned by localtime()\n\
 | |
| is used.");
 | |
| 
 | |
| static PyObject *
 | |
| time_ctime(PyObject *self, PyObject *args)
 | |
| {
 | |
|     time_t tt;
 | |
|     struct tm buf;
 | |
|     if (!parse_time_t_args(args, "|O:ctime", &tt))
 | |
|         return NULL;
 | |
|     if (pylocaltime(&tt, &buf) == -1)
 | |
|         return NULL;
 | |
|     return _asctime(&buf);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(ctime_doc,
 | |
| "ctime(seconds) -> string\n\
 | |
| \n\
 | |
| Convert a time in seconds since the Epoch to a string in local time.\n\
 | |
| This is equivalent to asctime(localtime(seconds)). When the time tuple is\n\
 | |
| not present, current time as returned by localtime() is used.");
 | |
| 
 | |
| #ifdef HAVE_MKTIME
 | |
| static PyObject *
 | |
| time_mktime(PyObject *self, PyObject *tup)
 | |
| {
 | |
|     struct tm buf;
 | |
|     time_t tt;
 | |
|     if (!gettmarg(tup, &buf))
 | |
|         return NULL;
 | |
|     buf.tm_wday = -1;  /* sentinel; original value ignored */
 | |
|     tt = mktime(&buf);
 | |
|     /* Return value of -1 does not necessarily mean an error, but tm_wday
 | |
|      * cannot remain set to -1 if mktime succeeded. */
 | |
|     if (tt == (time_t)(-1) && buf.tm_wday == -1) {
 | |
|         PyErr_SetString(PyExc_OverflowError,
 | |
|                         "mktime argument out of range");
 | |
|         return NULL;
 | |
|     }
 | |
|     return PyFloat_FromDouble((double)tt);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(mktime_doc,
 | |
| "mktime(tuple) -> floating point number\n\
 | |
| \n\
 | |
| Convert a time tuple in local time to seconds since the Epoch.\n\
 | |
| Note that mktime(gmtime(0)) will not generally return zero for most\n\
 | |
| time zones; instead the returned value will either be equal to that\n\
 | |
| of the timezone or altzone attributes on the time module.");
 | |
| #endif /* HAVE_MKTIME */
 | |
| 
 | |
| #ifdef HAVE_WORKING_TZSET
 | |
| static void PyInit_timezone(PyObject *module);
 | |
| 
 | |
| static PyObject *
 | |
| time_tzset(PyObject *self, PyObject *unused)
 | |
| {
 | |
|     PyObject* m;
 | |
| 
 | |
|     m = PyImport_ImportModuleNoBlock("time");
 | |
|     if (m == NULL) {
 | |
|         return NULL;
 | |
|     }
 | |
| 
 | |
|     tzset();
 | |
| 
 | |
|     /* Reset timezone, altzone, daylight and tzname */
 | |
|     PyInit_timezone(m);
 | |
|     Py_DECREF(m);
 | |
| 
 | |
|     Py_INCREF(Py_None);
 | |
|     return Py_None;
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(tzset_doc,
 | |
| "tzset()\n\
 | |
| \n\
 | |
| Initialize, or reinitialize, the local timezone to the value stored in\n\
 | |
| os.environ['TZ']. The TZ environment variable should be specified in\n\
 | |
| standard Unix timezone format as documented in the tzset man page\n\
 | |
| (eg. 'US/Eastern', 'Europe/Amsterdam'). Unknown timezones will silently\n\
 | |
| fall back to UTC. If the TZ environment variable is not set, the local\n\
 | |
| timezone is set to the systems best guess of wallclock time.\n\
 | |
| Changing the TZ environment variable without calling tzset *may* change\n\
 | |
| the local timezone used by methods such as localtime, but this behaviour\n\
 | |
| should not be relied on.");
 | |
| #endif /* HAVE_WORKING_TZSET */
 | |
| 
 | |
| #if defined(MS_WINDOWS) || defined(__APPLE__) \
 | |
|     || (defined(HAVE_CLOCK_GETTIME) \
 | |
|         && (defined(CLOCK_HIGHRES) || defined(CLOCK_MONOTONIC)))
 | |
| #define PYMONOTONIC
 | |
| #endif
 | |
| 
 | |
| #ifdef PYMONOTONIC
 | |
| static PyObject*
 | |
| pymonotonic(_Py_clock_info_t *info)
 | |
| {
 | |
| #if defined(MS_WINDOWS)
 | |
|     static ULONGLONG (*GetTickCount64) (void) = NULL;
 | |
|     static ULONGLONG (CALLBACK *Py_GetTickCount64)(void);
 | |
|     static int has_getickcount64 = -1;
 | |
|     double result;
 | |
| 
 | |
|     if (has_getickcount64 == -1) {
 | |
|         /* GetTickCount64() was added to Windows Vista */
 | |
|         if (winver.dwMajorVersion >= 6) {
 | |
|             HINSTANCE hKernel32;
 | |
|             hKernel32 = GetModuleHandleW(L"KERNEL32");
 | |
|             *(FARPROC*)&Py_GetTickCount64 = GetProcAddress(hKernel32,
 | |
|                                                            "GetTickCount64");
 | |
|             has_getickcount64 = (Py_GetTickCount64 != NULL);
 | |
|         }
 | |
|         else
 | |
|             has_getickcount64 = 0;
 | |
|     }
 | |
| 
 | |
|     if (has_getickcount64) {
 | |
|         ULONGLONG ticks;
 | |
|         ticks = Py_GetTickCount64();
 | |
|         result = (double)ticks * 1e-3;
 | |
|     }
 | |
|     else {
 | |
|         static DWORD last_ticks = 0;
 | |
|         static DWORD n_overflow = 0;
 | |
|         DWORD ticks;
 | |
| 
 | |
|         ticks = GetTickCount();
 | |
|         if (ticks < last_ticks)
 | |
|             n_overflow++;
 | |
|         last_ticks = ticks;
 | |
| 
 | |
|         result = ldexp(n_overflow, 32);
 | |
|         result += ticks;
 | |
|         result *= 1e-3;
 | |
|     }
 | |
| 
 | |
|     if (info) {
 | |
|         DWORD timeAdjustment, timeIncrement;
 | |
|         BOOL isTimeAdjustmentDisabled, ok;
 | |
|         if (has_getickcount64)
 | |
|             info->implementation = "GetTickCount64()";
 | |
|         else
 | |
|             info->implementation = "GetTickCount()";
 | |
|         info->monotonic = 1;
 | |
|         ok = GetSystemTimeAdjustment(&timeAdjustment, &timeIncrement,
 | |
|                                      &isTimeAdjustmentDisabled);
 | |
|         if (!ok) {
 | |
|             PyErr_SetFromWindowsErr(0);
 | |
|             return NULL;
 | |
|         }
 | |
|         info->resolution = timeIncrement * 1e-7;
 | |
|         info->adjustable = 0;
 | |
|     }
 | |
|     return PyFloat_FromDouble(result);
 | |
| 
 | |
| #elif defined(__APPLE__)
 | |
|     static mach_timebase_info_data_t timebase;
 | |
|     uint64_t time;
 | |
|     double secs;
 | |
| 
 | |
|     if (timebase.denom == 0) {
 | |
|         /* According to the Technical Q&A QA1398, mach_timebase_info() cannot
 | |
|            fail: https://developer.apple.com/library/mac/#qa/qa1398/ */
 | |
|         (void)mach_timebase_info(&timebase);
 | |
|     }
 | |
| 
 | |
|     time = mach_absolute_time();
 | |
|     secs = (double)time * timebase.numer / timebase.denom * 1e-9;
 | |
|     if (info) {
 | |
|         info->implementation = "mach_absolute_time()";
 | |
|         info->resolution = (double)timebase.numer / timebase.denom * 1e-9;
 | |
|         info->monotonic = 1;
 | |
|         info->adjustable = 0;
 | |
|     }
 | |
|     return PyFloat_FromDouble(secs);
 | |
| 
 | |
| #elif defined(HAVE_CLOCK_GETTIME) && (defined(CLOCK_HIGHRES) || defined(CLOCK_MONOTONIC))
 | |
|     struct timespec tp;
 | |
| #ifdef CLOCK_HIGHRES
 | |
|     const clockid_t clk_id = CLOCK_HIGHRES;
 | |
|     const char *function = "clock_gettime(CLOCK_HIGHRES)";
 | |
| #else
 | |
|     const clockid_t clk_id = CLOCK_MONOTONIC;
 | |
|     const char *function = "clock_gettime(CLOCK_MONOTONIC)";
 | |
| #endif
 | |
| 
 | |
|     if (clock_gettime(clk_id, &tp) != 0) {
 | |
|         PyErr_SetFromErrno(PyExc_OSError);
 | |
|         return NULL;
 | |
|     }
 | |
| 
 | |
|     if (info) {
 | |
|         struct timespec res;
 | |
|         info->monotonic = 1;
 | |
|         info->implementation = function;
 | |
|         info->adjustable = 0;
 | |
|         if (clock_getres(clk_id, &res) == 0)
 | |
|             info->resolution = res.tv_sec + res.tv_nsec * 1e-9;
 | |
|         else
 | |
|             info->resolution = 1e-9;
 | |
|     }
 | |
|     return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
 | |
| #endif
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_monotonic(PyObject *self, PyObject *unused)
 | |
| {
 | |
|     return pymonotonic(NULL);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(monotonic_doc,
 | |
| "monotonic() -> float\n\
 | |
| \n\
 | |
| Monotonic clock, cannot go backward.");
 | |
| #endif   /* PYMONOTONIC */
 | |
| 
 | |
| static PyObject*
 | |
| perf_counter(_Py_clock_info_t *info)
 | |
| {
 | |
| #if defined(WIN32_PERF_COUNTER) || defined(PYMONOTONIC)
 | |
|     PyObject *res;
 | |
| #endif
 | |
| #if defined(WIN32_PERF_COUNTER)
 | |
|     static int use_perf_counter = 1;
 | |
| #endif
 | |
| #ifdef PYMONOTONIC
 | |
|     static int use_monotonic = 1;
 | |
| #endif
 | |
| 
 | |
| #ifdef WIN32_PERF_COUNTER
 | |
|     if (use_perf_counter) {
 | |
|         if (win_perf_counter(info, &res) == 0)
 | |
|             return res;
 | |
|         use_perf_counter = 0;
 | |
|     }
 | |
| #endif
 | |
| 
 | |
| #ifdef PYMONOTONIC
 | |
|     if (use_monotonic) {
 | |
|         res = pymonotonic(info);
 | |
|         if (res != NULL)
 | |
|             return res;
 | |
|         use_monotonic = 0;
 | |
|         PyErr_Clear();
 | |
|     }
 | |
| #endif
 | |
| 
 | |
|     return floattime(info);
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_perf_counter(PyObject *self, PyObject *unused)
 | |
| {
 | |
|     return perf_counter(NULL);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(perf_counter_doc,
 | |
| "perf_counter() -> float\n\
 | |
| \n\
 | |
| Performance counter for benchmarking.");
 | |
| 
 | |
| static PyObject*
 | |
| py_process_time(_Py_clock_info_t *info)
 | |
| {
 | |
| #if defined(MS_WINDOWS)
 | |
|     HANDLE process;
 | |
|     FILETIME creation_time, exit_time, kernel_time, user_time;
 | |
|     ULARGE_INTEGER large;
 | |
|     double total;
 | |
|     BOOL ok;
 | |
| 
 | |
|     process = GetCurrentProcess();
 | |
|     ok = GetProcessTimes(process, &creation_time, &exit_time, &kernel_time, &user_time);
 | |
|     if (!ok)
 | |
|         return PyErr_SetFromWindowsErr(0);
 | |
| 
 | |
|     large.u.LowPart = kernel_time.dwLowDateTime;
 | |
|     large.u.HighPart = kernel_time.dwHighDateTime;
 | |
|     total = (double)large.QuadPart;
 | |
|     large.u.LowPart = user_time.dwLowDateTime;
 | |
|     large.u.HighPart = user_time.dwHighDateTime;
 | |
|     total += (double)large.QuadPart;
 | |
|     if (info) {
 | |
|         info->implementation = "GetProcessTimes()";
 | |
|         info->resolution = 1e-7;
 | |
|         info->monotonic = 1;
 | |
|         info->adjustable = 0;
 | |
|     }
 | |
|     return PyFloat_FromDouble(total * 1e-7);
 | |
| #else
 | |
| 
 | |
| #if defined(HAVE_SYS_RESOURCE_H)
 | |
|     struct rusage ru;
 | |
| #endif
 | |
| #ifdef HAVE_TIMES
 | |
|     struct tms t;
 | |
|     static long ticks_per_second = -1;
 | |
| #endif
 | |
| 
 | |
| #if defined(HAVE_CLOCK_GETTIME) \
 | |
|     && (defined(CLOCK_PROCESS_CPUTIME_ID) || defined(CLOCK_PROF))
 | |
|     struct timespec tp;
 | |
| #ifdef CLOCK_PROF
 | |
|     const clockid_t clk_id = CLOCK_PROF;
 | |
|     const char *function = "clock_gettime(CLOCK_PROF)";
 | |
| #else
 | |
|     const clockid_t clk_id = CLOCK_PROCESS_CPUTIME_ID;
 | |
|     const char *function = "clock_gettime(CLOCK_PROCESS_CPUTIME_ID)";
 | |
| #endif
 | |
| 
 | |
|     if (clock_gettime(clk_id, &tp) == 0) {
 | |
|         if (info) {
 | |
|             struct timespec res;
 | |
|             info->implementation = function;
 | |
|             info->monotonic = 1;
 | |
|             info->adjustable = 0;
 | |
|             if (clock_getres(clk_id, &res) == 0)
 | |
|                 info->resolution = res.tv_sec + res.tv_nsec * 1e-9;
 | |
|             else
 | |
|                 info->resolution = 1e-9;
 | |
|         }
 | |
|         return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
 | |
|     }
 | |
| #endif
 | |
| 
 | |
| #if defined(HAVE_SYS_RESOURCE_H)
 | |
|     if (getrusage(RUSAGE_SELF, &ru) == 0) {
 | |
|         double total;
 | |
|         total = ru.ru_utime.tv_sec + ru.ru_utime.tv_usec * 1e-6;
 | |
|         total += ru.ru_stime.tv_sec + ru.ru_stime.tv_usec * 1e-6;
 | |
|         if (info) {
 | |
|             info->implementation = "getrusage(RUSAGE_SELF)";
 | |
|             info->monotonic = 1;
 | |
|             info->adjustable = 0;
 | |
|             info->resolution = 1e-6;
 | |
|         }
 | |
|         return PyFloat_FromDouble(total);
 | |
|     }
 | |
| #endif
 | |
| 
 | |
| #ifdef HAVE_TIMES
 | |
|     if (times(&t) != (clock_t)-1) {
 | |
|         double total;
 | |
| 
 | |
|         if (ticks_per_second == -1) {
 | |
| #if defined(HAVE_SYSCONF) && defined(_SC_CLK_TCK)
 | |
|             ticks_per_second = sysconf(_SC_CLK_TCK);
 | |
|             if (ticks_per_second < 1)
 | |
|                 ticks_per_second = -1;
 | |
| #elif defined(HZ)
 | |
|             ticks_per_second = HZ;
 | |
| #else
 | |
|             ticks_per_second = 60; /* magic fallback value; may be bogus */
 | |
| #endif
 | |
|         }
 | |
| 
 | |
|         if (ticks_per_second != -1) {
 | |
|             total = (double)t.tms_utime / ticks_per_second;
 | |
|             total += (double)t.tms_stime / ticks_per_second;
 | |
|             if (info) {
 | |
|                 info->implementation = "times()";
 | |
|                 info->monotonic = 1;
 | |
|                 info->adjustable = 0;
 | |
|                 info->resolution = 1.0 / ticks_per_second;
 | |
|             }
 | |
|             return PyFloat_FromDouble(total);
 | |
|         }
 | |
|     }
 | |
| #endif
 | |
| 
 | |
|     return floatclock(info);
 | |
| #endif
 | |
| }
 | |
| 
 | |
| static PyObject *
 | |
| time_process_time(PyObject *self, PyObject *unused)
 | |
| {
 | |
|     return py_process_time(NULL);
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(process_time_doc,
 | |
| "process_time() -> float\n\
 | |
| \n\
 | |
| Process time for profiling: sum of the kernel and user-space CPU time.");
 | |
| 
 | |
| 
 | |
| static PyObject *
 | |
| time_get_clock_info(PyObject *self, PyObject *args)
 | |
| {
 | |
|     char *name;
 | |
|     _Py_clock_info_t info;
 | |
|     PyObject *obj = NULL, *dict, *ns;
 | |
| 
 | |
|     if (!PyArg_ParseTuple(args, "s:get_clock_info", &name))
 | |
|         return NULL;
 | |
| 
 | |
| #ifdef Py_DEBUG
 | |
|     info.implementation = NULL;
 | |
|     info.monotonic = -1;
 | |
|     info.adjustable = -1;
 | |
|     info.resolution = -1.0;
 | |
| #else
 | |
|     info.implementation = "";
 | |
|     info.monotonic = 0;
 | |
|     info.adjustable = 0;
 | |
|     info.resolution = 1.0;
 | |
| #endif
 | |
| 
 | |
|     if (strcmp(name, "time") == 0)
 | |
|         obj = floattime(&info);
 | |
| #ifdef PYCLOCK
 | |
|     else if (strcmp(name, "clock") == 0)
 | |
|         obj = pyclock(&info);
 | |
| #endif
 | |
| #ifdef PYMONOTONIC
 | |
|     else if (strcmp(name, "monotonic") == 0)
 | |
|         obj = pymonotonic(&info);
 | |
| #endif
 | |
|     else if (strcmp(name, "perf_counter") == 0)
 | |
|         obj = perf_counter(&info);
 | |
|     else if (strcmp(name, "process_time") == 0)
 | |
|         obj = py_process_time(&info);
 | |
|     else {
 | |
|         PyErr_SetString(PyExc_ValueError, "unknown clock");
 | |
|         return NULL;
 | |
|     }
 | |
|     if (obj == NULL)
 | |
|         return NULL;
 | |
|     Py_DECREF(obj);
 | |
| 
 | |
|     dict = PyDict_New();
 | |
|     if (dict == NULL)
 | |
|         return NULL;
 | |
| 
 | |
|     assert(info.implementation != NULL);
 | |
|     obj = PyUnicode_FromString(info.implementation);
 | |
|     if (obj == NULL)
 | |
|         goto error;
 | |
|     if (PyDict_SetItemString(dict, "implementation", obj) == -1)
 | |
|         goto error;
 | |
|     Py_CLEAR(obj);
 | |
| 
 | |
|     assert(info.monotonic != -1);
 | |
|     obj = PyBool_FromLong(info.monotonic);
 | |
|     if (obj == NULL)
 | |
|         goto error;
 | |
|     if (PyDict_SetItemString(dict, "monotonic", obj) == -1)
 | |
|         goto error;
 | |
|     Py_CLEAR(obj);
 | |
| 
 | |
|     assert(info.adjustable != -1);
 | |
|     obj = PyBool_FromLong(info.adjustable);
 | |
|     if (obj == NULL)
 | |
|         goto error;
 | |
|     if (PyDict_SetItemString(dict, "adjustable", obj) == -1)
 | |
|         goto error;
 | |
|     Py_CLEAR(obj);
 | |
| 
 | |
|     assert(info.resolution > 0.0);
 | |
|     assert(info.resolution <= 1.0);
 | |
|     obj = PyFloat_FromDouble(info.resolution);
 | |
|     if (obj == NULL)
 | |
|         goto error;
 | |
|     if (PyDict_SetItemString(dict, "resolution", obj) == -1)
 | |
|         goto error;
 | |
|     Py_CLEAR(obj);
 | |
| 
 | |
|     ns = _PyNamespace_New(dict);
 | |
|     Py_DECREF(dict);
 | |
|     return ns;
 | |
| 
 | |
| error:
 | |
|     Py_DECREF(dict);
 | |
|     Py_XDECREF(obj);
 | |
|     return NULL;
 | |
| }
 | |
| 
 | |
| PyDoc_STRVAR(get_clock_info_doc,
 | |
| "get_clock_info(name: str) -> dict\n\
 | |
| \n\
 | |
| Get information of the specified clock.");
 | |
| 
 | |
| static void
 | |
| PyInit_timezone(PyObject *m) {
 | |
|     /* This code moved from PyInit_time wholesale to allow calling it from
 | |
|     time_tzset. In the future, some parts of it can be moved back
 | |
|     (for platforms that don't HAVE_WORKING_TZSET, when we know what they
 | |
|     are), and the extraneous calls to tzset(3) should be removed.
 | |
|     I haven't done this yet, as I don't want to change this code as
 | |
|     little as possible when introducing the time.tzset and time.tzsetwall
 | |
|     methods. This should simply be a method of doing the following once,
 | |
|     at the top of this function and removing the call to tzset() from
 | |
|     time_tzset():
 | |
| 
 | |
|         #ifdef HAVE_TZSET
 | |
|         tzset()
 | |
|         #endif
 | |
| 
 | |
|     And I'm lazy and hate C so nyer.
 | |
|      */
 | |
| #if defined(HAVE_TZNAME) && !defined(__GLIBC__) && !defined(__CYGWIN__)
 | |
|     PyObject *otz0, *otz1;
 | |
|     tzset();
 | |
|     PyModule_AddIntConstant(m, "timezone", timezone);
 | |
| #ifdef HAVE_ALTZONE
 | |
|     PyModule_AddIntConstant(m, "altzone", altzone);
 | |
| #else
 | |
|     PyModule_AddIntConstant(m, "altzone", timezone-3600);
 | |
| #endif
 | |
|     PyModule_AddIntConstant(m, "daylight", daylight);
 | |
|     otz0 = PyUnicode_DecodeLocale(tzname[0], "surrogateescape");
 | |
|     otz1 = PyUnicode_DecodeLocale(tzname[1], "surrogateescape");
 | |
|     PyModule_AddObject(m, "tzname", Py_BuildValue("(NN)", otz0, otz1));
 | |
| #else /* !HAVE_TZNAME || __GLIBC__ || __CYGWIN__*/
 | |
| #ifdef HAVE_STRUCT_TM_TM_ZONE
 | |
|     {
 | |
| #define YEAR ((time_t)((365 * 24 + 6) * 3600))
 | |
|         time_t t;
 | |
|         struct tm *p;
 | |
|         long janzone, julyzone;
 | |
|         char janname[10], julyname[10];
 | |
|         t = (time((time_t *)0) / YEAR) * YEAR;
 | |
|         p = localtime(&t);
 | |
|         janzone = -p->tm_gmtoff;
 | |
|         strncpy(janname, p->tm_zone ? p->tm_zone : "   ", 9);
 | |
|         janname[9] = '\0';
 | |
|         t += YEAR/2;
 | |
|         p = localtime(&t);
 | |
|         julyzone = -p->tm_gmtoff;
 | |
|         strncpy(julyname, p->tm_zone ? p->tm_zone : "   ", 9);
 | |
|         julyname[9] = '\0';
 | |
| 
 | |
|         if( janzone < julyzone ) {
 | |
|             /* DST is reversed in the southern hemisphere */
 | |
|             PyModule_AddIntConstant(m, "timezone", julyzone);
 | |
|             PyModule_AddIntConstant(m, "altzone", janzone);
 | |
|             PyModule_AddIntConstant(m, "daylight",
 | |
|                                     janzone != julyzone);
 | |
|             PyModule_AddObject(m, "tzname",
 | |
|                                Py_BuildValue("(zz)",
 | |
|                                              julyname, janname));
 | |
|         } else {
 | |
|             PyModule_AddIntConstant(m, "timezone", janzone);
 | |
|             PyModule_AddIntConstant(m, "altzone", julyzone);
 | |
|             PyModule_AddIntConstant(m, "daylight",
 | |
|                                     janzone != julyzone);
 | |
|             PyModule_AddObject(m, "tzname",
 | |
|                                Py_BuildValue("(zz)",
 | |
|                                              janname, julyname));
 | |
|         }
 | |
|     }
 | |
| #else
 | |
| #endif /* HAVE_STRUCT_TM_TM_ZONE */
 | |
| #ifdef __CYGWIN__
 | |
|     tzset();
 | |
|     PyModule_AddIntConstant(m, "timezone", _timezone);
 | |
|     PyModule_AddIntConstant(m, "altzone", _timezone-3600);
 | |
|     PyModule_AddIntConstant(m, "daylight", _daylight);
 | |
|     PyModule_AddObject(m, "tzname",
 | |
|                        Py_BuildValue("(zz)", _tzname[0], _tzname[1]));
 | |
| #endif /* __CYGWIN__ */
 | |
| #endif /* !HAVE_TZNAME || __GLIBC__ || __CYGWIN__*/
 | |
| 
 | |
| #if defined(HAVE_CLOCK_GETTIME)
 | |
|     PyModule_AddIntMacro(m, CLOCK_REALTIME);
 | |
| #ifdef CLOCK_MONOTONIC
 | |
|     PyModule_AddIntMacro(m, CLOCK_MONOTONIC);
 | |
| #endif
 | |
| #ifdef CLOCK_MONOTONIC_RAW
 | |
|     PyModule_AddIntMacro(m, CLOCK_MONOTONIC_RAW);
 | |
| #endif
 | |
| #ifdef CLOCK_HIGHRES
 | |
|     PyModule_AddIntMacro(m, CLOCK_HIGHRES);
 | |
| #endif
 | |
| #ifdef CLOCK_PROCESS_CPUTIME_ID
 | |
|     PyModule_AddIntMacro(m, CLOCK_PROCESS_CPUTIME_ID);
 | |
| #endif
 | |
| #ifdef CLOCK_THREAD_CPUTIME_ID
 | |
|     PyModule_AddIntMacro(m, CLOCK_THREAD_CPUTIME_ID);
 | |
| #endif
 | |
| #endif /* HAVE_CLOCK_GETTIME */
 | |
| }
 | |
| 
 | |
| 
 | |
| static PyMethodDef time_methods[] = {
 | |
|     {"time",            time_time, METH_NOARGS, time_doc},
 | |
| #ifdef PYCLOCK
 | |
|     {"clock",           time_clock, METH_NOARGS, clock_doc},
 | |
| #endif
 | |
| #ifdef HAVE_CLOCK_GETTIME
 | |
|     {"clock_gettime",   time_clock_gettime, METH_VARARGS, clock_gettime_doc},
 | |
|     {"clock_settime",   time_clock_settime, METH_VARARGS, clock_settime_doc},
 | |
|     {"clock_getres",    time_clock_getres, METH_VARARGS, clock_getres_doc},
 | |
| #endif
 | |
|     {"sleep",           time_sleep, METH_VARARGS, sleep_doc},
 | |
|     {"gmtime",          time_gmtime, METH_VARARGS, gmtime_doc},
 | |
|     {"localtime",       time_localtime, METH_VARARGS, localtime_doc},
 | |
|     {"asctime",         time_asctime, METH_VARARGS, asctime_doc},
 | |
|     {"ctime",           time_ctime, METH_VARARGS, ctime_doc},
 | |
| #ifdef HAVE_MKTIME
 | |
|     {"mktime",          time_mktime, METH_O, mktime_doc},
 | |
| #endif
 | |
| #ifdef HAVE_STRFTIME
 | |
|     {"strftime",        time_strftime, METH_VARARGS, strftime_doc},
 | |
| #endif
 | |
|     {"strptime",        time_strptime, METH_VARARGS, strptime_doc},
 | |
| #ifdef HAVE_WORKING_TZSET
 | |
|     {"tzset",           time_tzset, METH_NOARGS, tzset_doc},
 | |
| #endif
 | |
| #ifdef PYMONOTONIC
 | |
|     {"monotonic",       time_monotonic, METH_NOARGS, monotonic_doc},
 | |
| #endif
 | |
|     {"process_time",    time_process_time, METH_NOARGS, process_time_doc},
 | |
|     {"perf_counter",    time_perf_counter, METH_NOARGS, perf_counter_doc},
 | |
|     {"get_clock_info",  time_get_clock_info, METH_VARARGS, get_clock_info_doc},
 | |
|     {NULL,              NULL}           /* sentinel */
 | |
| };
 | |
| 
 | |
| 
 | |
| PyDoc_STRVAR(module_doc,
 | |
| "This module provides various functions to manipulate time values.\n\
 | |
| \n\
 | |
| There are two standard representations of time.  One is the number\n\
 | |
| of seconds since the Epoch, in UTC (a.k.a. GMT).  It may be an integer\n\
 | |
| or a floating point number (to represent fractions of seconds).\n\
 | |
| The Epoch is system-defined; on Unix, it is generally January 1st, 1970.\n\
 | |
| The actual value can be retrieved by calling gmtime(0).\n\
 | |
| \n\
 | |
| The other representation is a tuple of 9 integers giving local time.\n\
 | |
| The tuple items are:\n\
 | |
|   year (including century, e.g. 1998)\n\
 | |
|   month (1-12)\n\
 | |
|   day (1-31)\n\
 | |
|   hours (0-23)\n\
 | |
|   minutes (0-59)\n\
 | |
|   seconds (0-59)\n\
 | |
|   weekday (0-6, Monday is 0)\n\
 | |
|   Julian day (day in the year, 1-366)\n\
 | |
|   DST (Daylight Savings Time) flag (-1, 0 or 1)\n\
 | |
| If the DST flag is 0, the time is given in the regular time zone;\n\
 | |
| if it is 1, the time is given in the DST time zone;\n\
 | |
| if it is -1, mktime() should guess based on the date and time.\n\
 | |
| \n\
 | |
| Variables:\n\
 | |
| \n\
 | |
| timezone -- difference in seconds between UTC and local standard time\n\
 | |
| altzone -- difference in  seconds between UTC and local DST time\n\
 | |
| daylight -- whether local time should reflect DST\n\
 | |
| tzname -- tuple of (standard time zone name, DST time zone name)\n\
 | |
| \n\
 | |
| Functions:\n\
 | |
| \n\
 | |
| time() -- return current time in seconds since the Epoch as a float\n\
 | |
| clock() -- return CPU time since process start as a float\n\
 | |
| sleep() -- delay for a number of seconds given as a float\n\
 | |
| gmtime() -- convert seconds since Epoch to UTC tuple\n\
 | |
| localtime() -- convert seconds since Epoch to local time tuple\n\
 | |
| asctime() -- convert time tuple to string\n\
 | |
| ctime() -- convert time in seconds to string\n\
 | |
| mktime() -- convert local time tuple to seconds since Epoch\n\
 | |
| strftime() -- convert time tuple to string according to format specification\n\
 | |
| strptime() -- parse string to time tuple according to format specification\n\
 | |
| tzset() -- change the local timezone");
 | |
| 
 | |
| 
 | |
| 
 | |
| static struct PyModuleDef timemodule = {
 | |
|     PyModuleDef_HEAD_INIT,
 | |
|     "time",
 | |
|     module_doc,
 | |
|     -1,
 | |
|     time_methods,
 | |
|     NULL,
 | |
|     NULL,
 | |
|     NULL,
 | |
|     NULL
 | |
| };
 | |
| 
 | |
| PyMODINIT_FUNC
 | |
| PyInit_time(void)
 | |
| {
 | |
|     PyObject *m;
 | |
|     m = PyModule_Create(&timemodule);
 | |
|     if (m == NULL)
 | |
|         return NULL;
 | |
| 
 | |
|     /* Set, or reset, module variables like time.timezone */
 | |
|     PyInit_timezone(m);
 | |
| 
 | |
|     if (!initialized) {
 | |
|         PyStructSequence_InitType(&StructTimeType,
 | |
|                                   &struct_time_type_desc);
 | |
| 
 | |
| #ifdef MS_WINDOWS
 | |
|         winver.dwOSVersionInfoSize = sizeof(winver);
 | |
|         if (!GetVersionEx((OSVERSIONINFO*)&winver)) {
 | |
|             Py_DECREF(m);
 | |
|             PyErr_SetFromWindowsErr(0);
 | |
|             return NULL;
 | |
|         }
 | |
| #endif
 | |
|     }
 | |
|     Py_INCREF(&StructTimeType);
 | |
| #ifdef HAVE_STRUCT_TM_TM_ZONE
 | |
|     PyModule_AddIntConstant(m, "_STRUCT_TM_ITEMS", 11);
 | |
| #else
 | |
|     PyModule_AddIntConstant(m, "_STRUCT_TM_ITEMS", 9);
 | |
| #endif
 | |
|     PyModule_AddObject(m, "struct_time", (PyObject*) &StructTimeType);
 | |
|     initialized = 1;
 | |
|     return m;
 | |
| }
 | |
| 
 | |
| static PyObject*
 | |
| floattime(_Py_clock_info_t *info)
 | |
| {
 | |
|     _PyTime_timeval t;
 | |
| #ifdef HAVE_CLOCK_GETTIME
 | |
|     struct timespec tp;
 | |
|     int ret;
 | |
| 
 | |
|     /* _PyTime_gettimeofday() does not use clock_gettime()
 | |
|        because it would require to link Python to the rt (real-time)
 | |
|        library, at least on Linux */
 | |
|     ret = clock_gettime(CLOCK_REALTIME, &tp);
 | |
|     if (ret == 0) {
 | |
|         if (info) {
 | |
|             struct timespec res;
 | |
|             info->implementation = "clock_gettime(CLOCK_REALTIME)";
 | |
|             info->monotonic = 0;
 | |
|             info->adjustable = 1;
 | |
|             if (clock_getres(CLOCK_REALTIME, &res) == 0)
 | |
|                 info->resolution = res.tv_sec + res.tv_nsec * 1e-9;
 | |
|             else
 | |
|                 info->resolution = 1e-9;
 | |
|         }
 | |
|         return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
 | |
|     }
 | |
| #endif
 | |
|     _PyTime_gettimeofday_info(&t, info);
 | |
|     return PyFloat_FromDouble((double)t.tv_sec + t.tv_usec * 1e-6);
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Implement floatsleep() for various platforms.
 | |
|    When interrupted (or when another error occurs), return -1 and
 | |
|    set an exception; else return 0. */
 | |
| 
 | |
| static int
 | |
| floatsleep(double secs)
 | |
| {
 | |
| /* XXX Should test for MS_WINDOWS first! */
 | |
| #if defined(HAVE_SELECT) && !defined(__EMX__)
 | |
|     struct timeval t;
 | |
|     double frac;
 | |
|     int err;
 | |
| 
 | |
|     frac = fmod(secs, 1.0);
 | |
|     secs = floor(secs);
 | |
|     t.tv_sec = (long)secs;
 | |
|     t.tv_usec = (long)(frac*1000000.0);
 | |
|     Py_BEGIN_ALLOW_THREADS
 | |
|     err = select(0, (fd_set *)0, (fd_set *)0, (fd_set *)0, &t);
 | |
|     Py_END_ALLOW_THREADS
 | |
|     if (err != 0) {
 | |
| #ifdef EINTR
 | |
|         if (errno == EINTR) {
 | |
|             if (PyErr_CheckSignals())
 | |
|                 return -1;
 | |
|         }
 | |
|         else
 | |
| #endif
 | |
|         {
 | |
|             PyErr_SetFromErrno(PyExc_IOError);
 | |
|             return -1;
 | |
|         }
 | |
|     }
 | |
| #elif defined(__WATCOMC__) && !defined(__QNX__)
 | |
|     /* XXX Can't interrupt this sleep */
 | |
|     Py_BEGIN_ALLOW_THREADS
 | |
|     delay((int)(secs * 1000 + 0.5));  /* delay() uses milliseconds */
 | |
|     Py_END_ALLOW_THREADS
 | |
| #elif defined(MS_WINDOWS)
 | |
|     {
 | |
|         double millisecs = secs * 1000.0;
 | |
|         unsigned long ul_millis;
 | |
| 
 | |
|         if (millisecs > (double)ULONG_MAX) {
 | |
|             PyErr_SetString(PyExc_OverflowError,
 | |
|                             "sleep length is too large");
 | |
|             return -1;
 | |
|         }
 | |
|         Py_BEGIN_ALLOW_THREADS
 | |
|         /* Allow sleep(0) to maintain win32 semantics, and as decreed
 | |
|          * by Guido, only the main thread can be interrupted.
 | |
|          */
 | |
|         ul_millis = (unsigned long)millisecs;
 | |
|         if (ul_millis == 0 || !_PyOS_IsMainThread())
 | |
|             Sleep(ul_millis);
 | |
|         else {
 | |
|             DWORD rc;
 | |
|             HANDLE hInterruptEvent = _PyOS_SigintEvent();
 | |
|             ResetEvent(hInterruptEvent);
 | |
|             rc = WaitForSingleObjectEx(hInterruptEvent, ul_millis, FALSE);
 | |
|             if (rc == WAIT_OBJECT_0) {
 | |
|                 Py_BLOCK_THREADS
 | |
|                 errno = EINTR;
 | |
|                 PyErr_SetFromErrno(PyExc_IOError);
 | |
|                 return -1;
 | |
|             }
 | |
|         }
 | |
|         Py_END_ALLOW_THREADS
 | |
|     }
 | |
| #else
 | |
|     /* XXX Can't interrupt this sleep */
 | |
|     Py_BEGIN_ALLOW_THREADS
 | |
|     sleep((int)secs);
 | |
|     Py_END_ALLOW_THREADS
 | |
| #endif
 | |
| 
 | |
|     return 0;
 | |
| }
 | 
