This file is indexed.

/usr/share/doc/cl-uffi/examples/strtol.lisp is in cl-uffi 2.1.2-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 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
;;;; -*- Mode: Lisp; Syntax: ANSI-Common-Lisp; Base: 10 -*-
;;;; *************************************************************************
;;;; FILE IDENTIFICATION
;;;;
;;;; Name:          strtol.cl
;;;; Purpose:       UFFI Example file to strtol, uses pointer arithmetic
;;;; Programmer:    Kevin M. Rosenberg
;;;; Date Started:  Feb 2002
;;;;
;;;; This file, part of UFFI, is Copyright (c) 2002-2010 by Kevin M. Rosenberg
;;;;
;;;; *************************************************************************

(in-package :cl-user)

(uffi:def-foreign-type char-ptr (* :unsigned-char))

;; This example does not use :cstring to pass the input string since
;; the routine needs to do pointer arithmetic to see how many characters
;; were parsed

(uffi:def-function ("strtol" c-strtol)
    ((nptr char-ptr)
     (endptr (* char-ptr))
     (base :int))
  :returning :long)

(defun strtol (str &optional (base 10))
  "Returns a long int from a string. Returns number and condition flag.
Condition flag is T if all of string parses as a long, NIL if
their was no string at all, or an integer indicating position in string
of first non-valid character"
  (let* ((str-native (uffi:convert-to-foreign-string str))
         (endptr (uffi:allocate-foreign-object 'char-ptr))
         (value (c-strtol str-native endptr base))
         (endptr-value (uffi:deref-pointer endptr 'char-ptr)))

    (unwind-protect
         (if (uffi:null-pointer-p endptr-value)
             (values value t)
             (let ((next-char-value (uffi:deref-pointer endptr-value :unsigned-char))
                   (chars-parsed (- (uffi:pointer-address endptr-value)
                                    (uffi:pointer-address str-native))))
               (cond
                 ((zerop chars-parsed)
                  (values nil nil))
                 ((uffi:null-char-p next-char-value)
                  (values value t))
                 (t
                  (values value chars-parsed)))))
      (progn
        (uffi:free-foreign-object str-native)
        (uffi:free-foreign-object endptr)))))



#+examples-uffi
(progn
  (flet ((print-results (str)
           (multiple-value-bind (result flag) (strtol str)
             (format t "~&(strtol ~S) => ~S,~S" str result flag))))
    (print-results "55")
    (print-results "55.3")
    (print-results "a")))

#+test-uffi
(progn
  (flet ((test-strtol (str results)
           (util.test:test (multiple-value-list (strtol str)) results
                           :test #'equal
                           :fail-info "Error testing strtol")))
    (test-strtol "123" '(123 t))
    (test-strtol "0" '(0 t))
    (test-strtol "55a" '(55 2))
    (test-strtol "a" '(nil nil))))