]> dreyeck.freedombox.rocks Git - topic-maps.git/blobdiff - src/ctm/unicode.lisp
Qualify closed XML/C14N 1.0 infrastructure for XTM resourceData
[topic-maps.git] / src / ctm / unicode.lisp
index dcfc68e27afc041d93e5df55f8fe282fd03aa778..967b14b8a7e417ad1e8d4cc7b9f8762572d36e30 100644 (file)
                                        :position (+ position start)) out)
             (decf i))
           (write-char (char text i) out)))))
+
+
+;; Inspect the ASCII header before decoding (CTM 3.2). The strict UTF-8
+;; decoder above is unchanged; only the qualified ISO-8859-5 path is added.
+(defun ctm-unit-code (sequence position)
+  (let ((value (aref sequence position)))
+    (if (characterp value) (char-code value) value)))
+
+(defun ctm-ascii-prefix-p (sequence position prefix)
+  (and (<= (+ position (length prefix)) (length sequence))
+       (loop for c across prefix for i from position
+             always (= (char-code c) (ctm-unit-code sequence i)))))
+
+(defun ctm-encoding-name (sequence position unit)
+  "Return the ASCII charset name, end after its quote, and name position.
+CTM 3.2/3.6 permits only SP/TAB before this initial header's opening quote."
+  (let ((cursor (+ position (length "%encoding"))) (size (length sequence)))
+    (loop while (and (< cursor size) (member (ctm-unit-code sequence cursor) '(9 32))) do (incf cursor))
+    (unless (and (< cursor size) (= 34 (ctm-unit-code sequence cursor)))
+      (problem 'ctm-rejection :invalid-encoding-declaration cursor "Expected an encoding name in double quotes." unit))
+    (let ((start (incf cursor)))
+      (loop while (and (< cursor size) (/= 34 (ctm-unit-code sequence cursor))) do
+        (unless (and (<= 33 (ctm-unit-code sequence cursor) 126)
+                     (/= 92 (ctm-unit-code sequence cursor)))
+          (problem 'ctm-rejection :invalid-encoding-declaration cursor "Expected an ASCII charset name." unit))
+        (incf cursor))
+      (unless (and (< cursor size) (> cursor start))
+        (problem 'ctm-rejection :invalid-encoding-declaration cursor "Encoding name must be nonempty and have a closing quote." unit))
+      (values (map 'string (lambda (value) (if (characterp value) value (code-char value)))
+                   (subseq sequence start cursor)) (1+ cursor) start))))
+
+(defun ctm-encoding-kind (name)
+  "Only the IANA identities implemented here; ASCII names are case-insensitive."
+  (cond ((member name '("UTF-8" "csUTF8") :test #'string-equal) :utf-8)
+        ((member name '("ISO-8859-5" "ISO_8859-5:1988" "ISO_8859-5"
+                       "iso-ir-144" "cyrillic" "csISOLatinCyrillic")
+                 :test #'string-equal) :iso-8859-5)))
+
+(defun ctm-encoding-identity (name)
+  (or (ctm-encoding-kind name) (string-downcase name)))
+
+(defun decode-iso-8859-5 (bytes)
+  "SBCL's existing total single-byte codec, qualified against all 256 values."
+  #+sbcl
+  (sb-ext:octets-to-string (map '(vector (unsigned-byte 8)) #'identity bytes)
+                          :external-format :iso-8859-5)
+  #-sbcl
+  (problem 'ctm-unsupported :unsupported-encoding 0
+           "ISO-8859-5 decoding is qualified only on SBCL." :byte))
+
+(defun compatible-ctm-encoding (current declared position unit)
+  (when (and current (not (equal (ctm-encoding-identity current) (ctm-encoding-identity declared))))
+    (problem 'ctm-rejection :encoding-conflict position
+             (format nil "Encoding ~S conflicts with explicitly selected ~S." declared current) unit))
+  declared)
+
+(defun decode-ctm-octets (bytes &key encoding)
+  "Apply CTM 3.2 ordering: supplied encoding, BOM, declaration, default, decode.
+UTF-8 and ISO-8859-5 use their small, explicit IANA identity sets."
+  (check-type encoding (or null string))
+  (let* ((bom (and (>= (length bytes) 3) (= (aref bytes 0) #xef)
+                   (= (aref bytes 1) #xbb) (= (aref bytes 2) #xbf)))
+         (start (if bom 3 0)) (selected encoding) (name-position 0))
+    (when bom (setf selected (compatible-ctm-encoding selected "UTF-8" 0 :byte)))
+    (when (ctm-ascii-prefix-p bytes start "%encoding")
+      (multiple-value-bind (name end position) (ctm-encoding-name bytes start :byte)
+        (declare (ignore end))
+        (setf selected (compatible-ctm-encoding selected name position :byte)
+              name-position position)))
+    (case (ctm-encoding-kind (or selected "UTF-8"))
+      (:utf-8 (decode-utf8 bytes :strip-bom t))
+      (:iso-8859-5 (decode-iso-8859-5 bytes))
+      (otherwise
+       (problem 'ctm-unsupported :unsupported-encoding name-position
+                (format nil "Charset ~S is not implemented; supported CTM encodings are UTF-8 and ISO-8859-5." selected) :byte)))))