Update copyright year to 2014
[gnus] / lisp / parse-time.el
index d003251..f80f3ad 100644 (file)
@@ -1,16 +1,16 @@
-;;; parse-time.el --- Parsing time strings
+;;; parse-time.el --- parsing time strings
 
-;; Copyright (C) 1996, 2000 by Free Software Foundation, Inc.
+;; Copyright (C) 1996, 2000-2014 Free Software Foundation, Inc.
 
 ;; Author: Erik Naggum <erik@naggum.no>
 ;; Keywords: util
 
 ;; This file is part of GNU Emacs.
 
-;; GNU Emacs is free software; you can redistribute it and/or modify
+;; GNU Emacs 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, or (at your option)
-;; any later version.
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
 
 ;; GNU Emacs is distributed in the hope that it will be useful,
 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -18,9 +18,7 @@
 ;; GNU General Public License for more details.
 
 ;; You should have received a copy of the GNU General Public License
-;; along with GNU Emacs; see the file COPYING.  If not, write to
-;; the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-;; Boston, MA 02111-1307, USA.
+;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
 
 ;;; Commentary:
 
 ;; `parse-time-string' parses a time in a string and returns a list of 9
 ;; values, just like `decode-time', where unspecified elements in the
 ;; string are returned as nil.  `encode-time' may be applied on these
-;; valuse to obtain an internal time value.
+;; values to obtain an internal time value.
 
 ;;; Code:
 
 (eval-when-compile (require 'cl))      ;and ah ain't kiddin' 'bout it
 
-(defvar parse-time-syntax (make-vector 256 nil))
+(eval-and-compile
+  (when (featurep 'xemacs)
+    (defvar parse-time-syntax (make-vector 256 nil))))
 (defvar parse-time-digits (make-vector 256 nil))
 
 ;; Byte-compiler warnings
-(defvar elt)
-(defvar val)
+(defvar parse-time-elt)
+(defvar parse-time-val)
 
 (unless (aref parse-time-digits ?0)
   (loop for i from ?0 to ?9
     do (aset parse-time-digits i (- i ?0))))
 
-(unless (aref parse-time-syntax ?0)
-  (loop for i from ?0 to ?9
-    do (aset parse-time-syntax i ?0))
-  (loop for i from ?A to ?Z
-    do (aset parse-time-syntax i ?A))
-  (loop for i from ?a to ?z
-    do (aset parse-time-syntax i ?a))
-  (aset parse-time-syntax ?+ 1)
-  (aset parse-time-syntax ?- -1)
-  (aset parse-time-syntax ?: ?d)
-  )
+(when (featurep 'xemacs)
+  (unless (aref parse-time-syntax ?0)
+    (loop for i from ?0 to ?9
+         do (aset parse-time-syntax i ?0))
+    (loop for i from ?A to ?Z
+         do (aset parse-time-syntax i ?A))
+    (loop for i from ?a to ?z
+         do (aset parse-time-syntax i ?a))
+    (aset parse-time-syntax ?+ 1)
+    (aset parse-time-syntax ?- -1)
+    (aset parse-time-syntax ?: ?d)))
 
 (defsubst digit-char-p (char)
   (aref parse-time-digits char))
 
-(defsubst parse-time-string-chars (char)
-  (aref parse-time-syntax char))
+(eval-and-compile
+  (if (featurep 'xemacs)
+      (defsubst parse-time-string-chars (char)
+       (and (< char (length parse-time-syntax))
+            (aref parse-time-syntax char)))
+    (defsubst parse-time-string-chars (char)
+      (save-match-data
+       (let (case-fold-search str)
+         (cond ((eq char ?+) 1)
+               ((eq char ?-) -1)
+               ((eq char ?:) ?d)
+               ((string-match "[[:upper:]]" (setq str (string char))) ?A)
+               ((string-match "[[:lower:]]" str) ?a)
+               ((string-match "[[:digit:]]" str) ?0)))))))
 
 (put 'parse-error 'error-conditions '(parse-error error))
 (put 'parse-error 'error-message "Parsing error")
        (index 0)
        (c nil))
     (while (< index end)
-      (while (and (< index end)                ;skip invalid characters
+      (while (and (< index end)                ;Skip invalid characters.
                  (not (setq c (parse-time-string-chars (aref string index)))))
        (incf index))
       (setq start index all-digits (eq c ?0))
-      (while (and (< (incf index) end) ;scan valid characters
+      (while (and (< (incf index) end) ;Scan valid characters.
                  (setq c (parse-time-string-chars (aref string index))))
        (setq all-digits (and all-digits (eq c ?0))))
       (if (<= index end)
 (defvar parse-time-months '(("jan" . 1) ("feb" . 2) ("mar" . 3)
                            ("apr" . 4) ("may" . 5) ("jun" . 6)
                            ("jul" . 7) ("aug" . 8) ("sep" . 9)
-                           ("oct" . 10) ("nov" . 11) ("dec" . 12)))
+                           ("oct" . 10) ("nov" . 11) ("dec" . 12)
+                           ("january" . 1) ("february" . 2)
+                           ("march" . 3) ("april" . 4) ("june" . 6)
+                           ("july" . 7) ("august" . 8)
+                           ("september" . 9) ("october" . 10)
+                           ("november" . 11) ("december" . 12)))
 (defvar parse-time-weekdays '(("sun" . 0) ("mon" . 1) ("tue" . 2)
-                             ("wed" . 3) ("thu" . 4) ("fri" . 5) ("sat" . 6)))
+                             ("wed" . 3) ("thu" . 4) ("fri" . 5)
+                             ("sat" . 6) ("sunday" . 0) ("monday" . 1)
+                             ("tuesday" . 2) ("wednesday" . 3)
+                             ("thursday" . 4) ("friday" . 5)
+                             ("saturday" . 6)))
 (defvar parse-time-zoneinfo `(("z" 0) ("ut" 0) ("gmt" 0)
                              ("pst" ,(* -8 3600)) ("pdt" ,(* -7 3600) t)
                              ("mst" ,(* -7 3600)) ("mdt" ,(* -6 3600) t)
     ((4) parse-time-months)
     ((5) (100 4038))
     ((2 1 0)
-     ,#'(lambda () (and (stringp elt)
-                       (= (length elt) 8)
-                       (= (aref elt 2) ?:)
-                       (= (aref elt 5) ?:)))
+     ,#'(lambda () (and (stringp parse-time-elt)
+                       (= (length parse-time-elt) 8)
+                       (= (aref parse-time-elt 2) ?:)
+                       (= (aref parse-time-elt 5) ?:)))
      [0 2] [3 5] [6 8])
     ((8 7) parse-time-zoneinfo
-     ,#'(lambda () (car val))
-     ,#'(lambda () (cadr val)))
+     ,#'(lambda () (car parse-time-val))
+     ,#'(lambda () (cadr parse-time-val)))
     ((8)
      ,#'(lambda ()
-         (and (stringp elt)
-              (= 5 (length elt))
-              (or (= (aref elt 0) ?+) (= (aref elt 0) ?-))))
-     ,#'(lambda () (* 60 (+ (parse-integer elt 3 5)
-                           (* 60 (parse-integer elt 1 3)))
-                     (if (= (aref elt 0) ?-) -1 1))))
+         (and (stringp parse-time-elt)
+              (= 5 (length parse-time-elt))
+              (or (= (aref parse-time-elt 0) ?+)
+                  (= (aref parse-time-elt 0) ?-))))
+     ,#'(lambda () (* 60 (+ (parse-integer parse-time-elt 3 5)
+                           (* 60 (parse-integer parse-time-elt 1 3)))
+                     (if (= (aref parse-time-elt 0) ?-) -1 1))))
     ((5 4 3)
-     ,#'(lambda () (and (stringp elt)
-                       (= (length elt) 10)
-                       (= (aref elt 4) ?-)
-                       (= (aref elt 7) ?-)))
+     ,#'(lambda () (and (stringp parse-time-elt)
+                       (= (length parse-time-elt) 10)
+                       (= (aref parse-time-elt 4) ?-)
+                       (= (aref parse-time-elt 7) ?-)))
      [0 4] [5 7] [8 10])
     ((2 1 0)
-     ,#'(lambda () (and (stringp elt) (= (length elt) 5) (= (aref elt 2) ?:)))
+     ,#'(lambda () (and (stringp parse-time-elt)
+                       (= (length parse-time-elt) 5)
+                       (= (aref parse-time-elt 2) ?:)))
      [0 2] [3 5] ,#'(lambda () 0))
     ((2 1 0)
-     ,#'(lambda () (and (stringp elt)
-                       (= (length elt) 4)
-                       (= (aref elt 1) ?:)))
+     ,#'(lambda () (and (stringp parse-time-elt)
+                       (= (length parse-time-elt) 4)
+                       (= (aref parse-time-elt 1) ?:)))
      [0 1] [2 4] ,#'(lambda () 0))
     ((2 1 0)
-     ,#'(lambda () (and (stringp elt)
-                       (= (length elt) 7)
-                       (= (aref elt 1) ?:)))
+     ,#'(lambda () (and (stringp parse-time-elt)
+                       (= (length parse-time-elt) 7)
+                       (= (aref parse-time-elt 1) ?:)))
      [0 1] [2 4] [5 7])
-    ((5) (50 110) ,#'(lambda () (+ 1900 elt)))
-    ((5) (0 49) ,#'(lambda () (+ 2000 elt))))
+    ((5) (50 110) ,#'(lambda () (+ 1900 parse-time-elt)))
+    ((5) (0 49) ,#'(lambda () (+ 2000 parse-time-elt))))
   "(slots predicate extractor...)")
+;;;###autoload(put 'parse-time-rules 'risky-local-variable t)
 
+;;;###autoload
 (defun parse-time-string (string)
   "Parse the time-string STRING into (SEC MIN HOUR DAY MON YEAR DOW DST TZ).
 The values are identical to those of `decode-time', but any values that are
@@ -178,35 +204,38 @@ unknown are returned as nil."
   (let ((time (list nil nil nil nil nil nil nil nil nil))
        (temp (parse-time-tokenize (downcase string))))
     (while temp
-      (let ((elt (pop temp))
+      (let ((parse-time-elt (pop temp))
            (rules parse-time-rules)
            (exit nil))
-       (while (and (not (null rules)) (not exit))
+       (while (and rules (not exit))
          (let* ((rule (pop rules))
                 (slots (pop rule))
                 (predicate (pop rule))
-                (val))
+                (parse-time-val))
            (when (and (not (nth (car slots) time)) ;not already set
-                      (setq val (cond ((and (consp predicate)
-                                            (not (eq (car predicate)
-                                                     'lambda)))
-                                       (and (numberp elt)
-                                            (<= (car predicate) elt)
-                                            (<= elt (cadr predicate))
-                                            elt))
-                                      ((symbolp predicate)
-                                       (cdr (assoc elt
-                                                   (symbol-value predicate))))
-                                      ((funcall predicate)))))
+                      (setq parse-time-val
+                            (cond ((and (consp predicate)
+                                        (not (eq (car predicate)
+                                                 'lambda)))
+                                   (and (numberp parse-time-elt)
+                                        (<= (car predicate) parse-time-elt)
+                                        (<= parse-time-elt (cadr predicate))
+                                        parse-time-elt))
+                                  ((symbolp predicate)
+                                   (cdr (assoc parse-time-elt
+                                               (symbol-value predicate))))
+                                  ((funcall predicate)))))
              (setq exit t)
              (while slots
-               (let ((new-val (and rule
-                                   (let ((this (pop rule)))
-                                     (if (vectorp this)
-                                         (parse-integer
-                                          elt (aref this 0) (aref this 1))
-                                       (funcall this))))))
-                 (rplaca (nthcdr (pop slots) time) (or new-val val)))))))))
+               (let ((new-val (if rule
+                                  (let ((this (pop rule)))
+                                    (if (vectorp this)
+                                        (parse-integer
+                                         parse-time-elt
+                                         (aref this 0) (aref this 1))
+                                      (funcall this)))
+                                parse-time-val)))
+                 (rplaca (nthcdr (pop slots) time) new-val))))))))
     time))
 
 (provide 'parse-time)