File: strings.lisp

package info (click to toggle)
acl2 8.6%2Bdfsg-3
  • links: PTS
  • area: main
  • in suites: sid
  • size: 1,138,276 kB
  • sloc: lisp: 17,818,294; java: 125,359; python: 28,122; javascript: 23,458; cpp: 18,851; ansic: 11,569; perl: 7,678; xml: 5,591; sh: 3,978; makefile: 3,840; ruby: 2,633; yacc: 1,126; ml: 763; awk: 295; csh: 233; lex: 197; php: 178; tcl: 49; asm: 23; haskell: 17
file content (82 lines) | stat: -rw-r--r-- 4,082 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
;;; -*- Mode: LISP; Syntax: COMMON-LISP; Package: FLEXI-STREAMS; Base: 10 -*-
;;; $Header: /usr/local/cvsrep/flexi-streams/strings.lisp,v 1.34 2008/05/26 10:55:08 edi Exp $

;;; Copyright (c) 2005-2008, Dr. Edmund Weitz.  All rights reserved.

;;; Redistribution and use in source and binary forms, with or without
;;; modification, are permitted provided that the following conditions
;;; are met:

;;;   * Redistributions of source code must retain the above copyright
;;;     notice, this list of conditions and the following disclaimer.

;;;   * Redistributions in binary form must reproduce the above
;;;     copyright notice, this list of conditions and the following
;;;     disclaimer in the documentation and/or other materials
;;;     provided with the distribution.

;;; THIS SOFTWARE IS PROVIDED BY THE AUTHOR 'AS IS' AND ANY EXPRESSED
;;; OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
;;; WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
;;; ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
;;; DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
;;; DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
;;; GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
;;; INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
;;; WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
;;; NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
;;; SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

(in-package :flexi-streams)

(defun string-to-octets (string &key
                                (external-format :latin1)
                                (start 0) (end (length string)))
  "Converts the Lisp string STRING from START to END to an array of
octets corresponding to the external format designated by
EXTERNAL-FORMAT.

In spite of the name, STRING can be any sequence of characters, but
the function is optimized for strings."
  (declare #.*standard-optimize-settings*)
  (setq external-format (maybe-convert-external-format external-format))
  ;; the external format knows how to do it...
  (string-to-octets* external-format string start end))

(defun octets-to-string (sequence &key
                                  (external-format :latin1)
                                  (start 0) (end (length sequence)))
  "Converts the Lisp sequence SEQUENCE of octets from START to END to
a string using the external format designated by EXTERNAL-FORMAT.

This function is optimized for the case of SEQUENCE being a vector.
Don't use lists if you're in a hurry."
  (declare #.*standard-optimize-settings*)
  (declare (fixnum start end))
  (setq external-format (maybe-convert-external-format external-format))
  ;; the external format knows how to do it...
  (octets-to-string* external-format sequence start end))

(defun octet-length (string &key (external-format :latin1) (start 0) (end (length string)))
  "Returns the length of the substring of STRING from START to END in
octets if encoded using the external format EXTERNAL-FORMAT.

In spite of the name, STRING can be any sequence of characters, but
the function is optimized for strings."
  (declare #.*standard-optimize-settings*)
  (declare (fixnum start end))
  (setq external-format (maybe-convert-external-format external-format))
  (compute-number-of-octets external-format string start end))

(defun char-length (sequence &key (external-format :latin1) (start 0) (end (length sequence)))
  "Kind of the inverse of OCTET-LENGTH.  Returns the length of the
subsequence \(of octets) of SEQUENCE from START to END in characters
if decoded using the external format EXTERNAL-FORMAT.  Note that this
function doesn't check for the validity of the data in SEQUENCE.

This function is optimized for the case of SEQUENCE being a vector.
Don't use lists if you're in a hurry."
  (declare #.*standard-optimize-settings*)
  (declare (fixnum start end))
  (setq external-format (maybe-convert-external-format external-format))
  (compute-number-of-chars external-format sequence start end))