On this page:
14.1 First-class function (pointers)
14.2 A Compiler with Function pointers
7.4

14 Knock: first-class function (pointers)

    14.1 First-class function (pointers)

    14.2 A Compiler with Function pointers

14.1 First-class function (pointers)

With Iniquity and Jig, we have introduced functions and function calls, but functions are second-class language mechanisms: functions are not values. They cannot be computed. They cannot be stored in a list or box. They cannot be passed as arguments are returned as results of other functions.

This is too bad since so many program designs depend on the idea of computation-as-a-value at the heart of functional and object-oriented programming.

Let’s now remedy this problem by making functions first-class values in our language. We’ll call it Knock.

We add to the syntax two new forms, one for reference functions and one for calling a function where the function position is an arbitrary expression (that should evaluate to a function):

;; type Expr =

;; | ....

;; | `(fun ,Variable)

;; | `(call ,Expr ,@(Listof Expr))

These new syntactic forms are temporary forms that don’t correspond anything in Racket but make it a bit easier to present how first-class functions work. The (fun f) form is a reference to a function f, which is defined in the program. The (call e0 es ...) form is a function call where the function position, e0 is an arbitrary expression that should produce a function value.

We will end up eliminating them in future versions of the compiler; they are simply a crutch for now.

14.2 A Compiler with Function pointers

The main idea in making functions into values is we will need to have a representation of functions. We will use a representation similar to boxes: functions will be heap allocated data structures. What will be stored in the heap? The address of the label of the function.

A function reference, (fun f), will allocate a 64-bit segment of the heap, store the location of the function’s label, i.e. a pointer to the instructions for the function, and tag the pointer as a “procedure value,” which is new, disjoint kind of value.

; Variable -> Asm
(define (compile-fun f)
  `(; rax <- address of label f
    (lea rax (offset ,(symbol->label f) 0))
    ; write in to heap
    (mov (offset rdi 0) rax)
    ; rax <- pointer into heap
    (mov rax rdi)
    ; tag as procedure pointer
    (or rax ,type-proc)
    ; alloc
    (add rdi 8)))

A function call, (call e0 es ...) will evaluate on the subexpressions. The e0 expression should produce a function, i.e. tagged pointer. We can erase the tag to compute the address in the heap. Dereferencing that location, gets us the label address, which can then jump to.

; Expr (Listof Expr) CEnv -> Asm
(define (compile-fun-call e0 es c)
  (let ((cs (compile-es es (cons #f c)))
        (c0 (compile-e e0 c))
        (i (- (add1 (length c))))
        (stack-size (* 8 (length c))))
    `(,@c0
      ; save f in stack    
      (mov (offset rsp ,i) rax)
      ,@cs
      ; restore f      
      (mov rax (offset rsp ,i))
      ,@assert-proc
      (sub rsp ,stack-size)
      (xor rax ,type-proc)
      ; call f
      (call (offset rax 0))
      (add rsp ,stack-size))))

A tail call version of the above can be defined as:

; Expr (Listof Expr) CEnv -> Asm
(define (compile-fun-tail-call e0 es c)
  (let ((cs (compile-es es (cons #f c)))
        (c0 (compile-e e0 c))
        (i (- (add1 (length c)))))
    `(,@c0
      (mov (offset rsp ,i) rax)
      ,@cs
      (mov rax (offset rsp ,i))
      ,@(move-args (length es) i)
      ,@assert-proc
      (xor rax ,type-proc)
      (jmp (offset rax 0)))))

The complete compiler:

knock/compile.rkt

  #lang racket
  (provide (all-defined-out))
   
  ;; An immediate is anything ending in #b000
  ;; All other tags in mask #b111 are pointers
   
  (define result-shift     3)
  (define result-type-mask (sub1 (arithmetic-shift 1 result-shift)))
  (define type-imm         #b000)
  (define type-box         #b001)
  (define type-pair        #b010)
  (define type-string      #b011)
  (define type-proc        #b100) ;; <-- NEW: procedure value
   
  (define imm-shift        (+ 2 result-shift))
  (define imm-type-mask    (sub1 (arithmetic-shift 1 imm-shift)))
  (define imm-type-int     (arithmetic-shift #b00 result-shift))
  (define imm-type-bool    (arithmetic-shift #b01 result-shift))
  (define imm-type-char    (arithmetic-shift #b10 result-shift))
  (define imm-type-empty   (arithmetic-shift #b11 result-shift))
  (define imm-val-false    imm-type-bool)
  (define imm-val-true
    (bitwise-ior (arithmetic-shift 1 (add1 imm-shift)) imm-type-bool))
   
  ;; Allocate in 64-bit (8-byte) increments, so pointers
  ;; end in #b000 and we tag with #b001 for boxes, etc.
   
  ;; type CEnv = (Listof (Maybe Variable))
  ;; type Imm = Integer | Boolean | Char | ''()
   
  ;; type Prog =
  ;; | Expr
  ;; | `(begin ,@(Listof (define (,Variable ,@(Listof Variable)) ,Expr))
  ;;           ,Expr)
   
  ;; Prog -> Asm
  (define (compile p)
    (match p
      [(list 'begin `(define (,fs . ,xss) ,es) ... e0)
       (let ((ds (compile-defines fs xss es))
             (c0 (compile-entry e0)))
         `(,@c0
           ,@ds))]
      [e (compile-entry e)]))
   
  ;; Expr -> Asm
  ;; Compile e as the entry point
  (define (compile-entry e)
    `(entry
      ,@(compile-tail-e e '())
      ret
   
      err
      (push rbp)
      (call error)
      ret))
   
  ;; Expr CEnv -> Asm
  ;; Compile an expression in tail position
  (define (compile-tail-e e c)
    (match e
      [(? symbol? x)         (compile-variable x c)]
      [(? imm? i)            (compile-imm i)]
      [`(box ,e0)            (compile-box e0 c)]
      [`(unbox ,e0)          (compile-unbox e0 c)]
      [`(cons ,e0 ,e1)       (compile-cons e0 e1 c)]
      [`(car ,e0)            (compile-car e0 c)]
      [`(cdr ,e0)            (compile-cdr e0 c)]
      [`(add1 ,e0)           (compile-add1 e0 c)]
      [`(sub1 ,e0)           (compile-sub1 e0 c)]
      [`(zero? ,e0)          (compile-zero? e0 c)]
      [`(empty? ,e0)         (compile-empty? e0 c)]
      [`(if ,e0 ,e1 ,e2)     (compile-tail-if e0 e1 e2 c)]
      [`(+ ,e0 ,e1)          (compile-+ e0 e1 c)]
      [`(let ((,x ,e0)) ,e1) (compile-tail-let x e0 e1 c)]
      [`(fun ,f)             (compile-fun f)]
      [`(call ,e0 . ,es)     (compile-fun-tail-call e0 es c)]
      [`(,f . ,es)           (compile-tail-call f es c)]))
   
  ;; Expr CEnv -> Asm
  ;; Compile an expression in non-tail position
  (define (compile-e e c)
    (match e
      [(? symbol? x)         (compile-variable x c)]
      [(? imm? i)            (compile-imm i)]
      [`(box ,e0)            (compile-box e0 c)]
      [`(unbox ,e0)          (compile-unbox e0 c)]
      [`(cons ,e0 ,e1)       (compile-cons e0 e1 c)]
      [`(car ,e0)            (compile-car e0 c)]
      [`(cdr ,e0)            (compile-cdr e0 c)]
      [`(add1 ,e0)           (compile-add1 e0 c)]
      [`(sub1 ,e0)           (compile-sub1 e0 c)]
      [`(zero? ,e0)          (compile-zero? e0 c)]
      [`(empty? ,e0)         (compile-empty? e0 c)]
      [`(if ,e0 ,e1 ,e2)     (compile-if e0 e1 e2 c)]
      [`(+ ,e0 ,e1)          (compile-+ e0 e1 c)]
      [`(let ((,x ,e0)) ,e1) (compile-let x e0 e1 c)]
      [`(fun ,f)             (compile-fun f)]
      [`(call ,e0 . ,es)     (compile-fun-call e0 es c)]
      [`(,f . ,es)           (compile-call f es c)]))
   
  ;; Variable (Listof Expr) CEnv -> Asm
  ;; Statically know the function we're calling
  (define (compile-call f es c)
    (let ((cs (compile-es es (cons #f c)))
          (stack-size (* 8 (length c))))
      `(,@cs
        (sub rsp ,stack-size)
        (call ,(symbol->label f))
        (add rsp ,stack-size))))
   
  ;; Variable (Listof Expr) CEnv -> Asm
  ;; Compile a call in tail position
  (define (compile-tail-call f es c)
    (let ((cs (compile-es es c)))
      `(,@cs
        ,@(move-args (length es) (- (length c)))
        (jmp ,(symbol->label f)))))
   
  ;; Integer Integer -> Asm
  ;; Move i arguments upward on stack by offset off
  (define (move-args i off)
    (match i
          [0 '()]
          [_ `(,@(move-args (sub1 i) off)
               (mov rbx (offset rsp ,(- off i)))
               (mov (offset rsp ,(- i)) rbx))]))
   
  ;; Variable -> Asm
  (define (compile-fun f)
    `(; rax <- address of label f
      (lea rax (offset ,(symbol->label f) 0))
      ; write in to heap
      (mov (offset rdi 0) rax)
      ; rax <- pointer into heap
      (mov rax rdi)
      ; tag as procedure pointer
      (or rax ,type-proc)
      ; alloc
      (add rdi 8)))
   
  ;; Expr (Listof Expr) CEnv -> Asm
  (define (compile-fun-call e0 es c)
    (let ((cs (compile-es es (cons #f c)))
          (c0 (compile-e e0 c))
          (i (- (add1 (length c))))
          (stack-size (* 8 (length c))))
      `(,@c0
        (mov (offset rsp ,i) rax)
        ,@cs
        (mov rax (offset rsp ,i))
        ,@assert-proc
        (sub rsp ,stack-size)
        (xor rax ,type-proc)
        (call (offset rax 0))
        ;(call ,(symbol->label f))
        (add rsp ,stack-size))))
   
  ;; Expr (Listof Expr) CEnv -> Asm
  (define (compile-fun-tail-call e0 es c)
    (let ((cs (compile-es es (cons #f c)))
          (c0 (compile-e e0 c))
          (i (- (add1 (length c)))))
      `(,@c0
        (mov (offset rsp ,i) rax)
        ,@cs
        (mov rax (offset rsp ,i))
        ,@(move-args (length es) i)
        ,@assert-proc
        (xor rax ,type-proc)
        (jmp (offset rax 0)))))
   
  ;; (Listof Expr) CEnv -> Asm
  (define (compile-es es c)
    (match es
      ['() '()]
      [(cons e es)
       (let ((c0 (compile-e e c))
             (cs (compile-es es (cons #f c))))
         `(,@c0
           (mov (offset rsp ,(- (add1 (length c)))) rax)
           ,@cs))]))
   
  ;; Variable (Listof Variable) Expr -> Asm
  (define (compile-define f xs e0)
    (let ((c0 (compile-tail-e e0 (reverse xs))))
      `(,(symbol->label f)
        ,@c0
        ret)))
   
  ;; (Listof Variable) (Listof (Listof Variable)) (Listof Expr) -> Asm
  (define (compile-defines fs xss es)
    (append-map compile-define fs xss es))
   
  ;; Any -> Boolean
  (define (imm? x)
    (or (integer? x)
        (boolean? x)
        (char? x)
        (equal? ''() x)))
   
  ;; Imm -> Asm
  (define (compile-imm i)
    `((mov rax ,(imm->bits i))))
   
  ;; Imm -> Integer
  (define (imm->bits i)
    (match i
      [(? integer? i) (arithmetic-shift i imm-shift)]
      [(? char? c)    (+ (arithmetic-shift (char->integer c) imm-shift) imm-type-char)]
      [(? boolean? b) (if b imm-val-true imm-val-false)]
      [''()           imm-type-empty]))
   
  ;; Variable CEnv -> Asm
  (define (compile-variable x c)
    (let ((i (lookup x c)))
      `((mov rax (offset rsp ,(- (add1 i)))))))
   
  ;; Expr CEnv -> Asm
  (define (compile-box e0 c)
    (let ((c0 (compile-e e0 c)))
      `(,@c0
        (mov (offset rdi 0) rax)
        (mov rax rdi)
        (or rax ,type-box)
        (add rdi 8)))) ; allocate 8 bytes
   
  ;; Expr CEnv -> Asm
  (define (compile-unbox e0 c)
    (let ((c0 (compile-e e0 c)))
      `(,@c0
        ,@assert-box
        (xor rax ,type-box)
        (mov rax (offset rax 0)))))
   
  ;; Expr Expr CEnv -> Asm
  (define (compile-cons e0 e1 c)
    (let ((c0 (compile-e e0 c))
          (c1 (compile-e e1 (cons #f c))))
      `(,@c0
        (mov (offset rsp ,(- (add1 (length c)))) rax)
        ,@c1
        (mov (offset rdi 0) rax)
        (mov rax (offset rsp ,(- (add1 (length c)))))
        (mov (offset rdi 1) rax)
        (mov rax rdi)
        (or rax ,type-pair)
        (add rdi 16))))
   
  ;; Expr CEnv -> Asm
  (define (compile-car e0 c)
    (let ((c0 (compile-e e0 c)))
      `(,@c0
        ,@assert-pair
        (xor rax ,type-pair)
        (mov rax (offset rax 1)))))
   
  ;; Expr CEnv -> Asm
  (define (compile-cdr e0 c)
    (let ((c0 (compile-e e0 c)))
      `(,@c0
        ,@assert-pair
        (xor rax ,type-pair)
        (mov rax (offset rax 0)))))
   
  ;; Expr CEnv -> Asm
  (define (compile-empty? e0 c)
    (let ((c0 (compile-e e0 c))
          (l0 (gensym)))
      `(,@c0
        (and rax ,imm-type-mask)
        (cmp rax ,imm-type-empty)
        (mov rax ,imm-val-false)
        (jne ,l0)
        (mov rax ,imm-val-true)
        ,l0)))
   
  ;; Expr CEnv -> Asm
  (define (compile-add1 e0 c)
    (let ((c0 (compile-e e0 c)))
      `(,@c0
        ,@assert-integer
        (add rax ,(arithmetic-shift 1 imm-shift)))))
   
  ;; Expr CEnv -> Asm
  (define (compile-sub1 e0 c)
    (let ((c0 (compile-e e0 c)))
      `(,@c0
        ,@assert-integer
        (sub rax ,(arithmetic-shift 1 imm-shift)))))
   
  ;; Expr CEnv -> Asm
  (define (compile-zero? e0 c)
    (let ((c0 (compile-e e0 c))
          (l0 (gensym))
          (l1 (gensym)))
      `(,@c0
        ,@assert-integer
        (cmp rax 0)
        (mov rax ,imm-val-false)
        (jne ,l0)
        (mov rax ,imm-val-true)
        ,l0)))
   
  ;; Expr Expr Expr CEnv -> Asm
  (define (compile-if e0 e1 e2 c)
    (let ((c0 (compile-e e0 c))
          (c1 (compile-e e1 c))
          (c2 (compile-e e2 c))
          (l0 (gensym))
          (l1 (gensym)))
      `(,@c0
        (cmp rax ,imm-val-false)
        (je ,l0)
        ,@c1
        (jmp ,l1)
        ,l0
        ,@c2
        ,l1)))
   
  ;; Expr Expr Expr CEnv -> Asm
  (define (compile-tail-if e0 e1 e2 c)
    (let ((c0 (compile-e e0 c))
          (c1 (compile-tail-e e1 c))
          (c2 (compile-tail-e e2 c))
          (l0 (gensym))
          (l1 (gensym)))
      `(,@c0
        (cmp rax ,imm-val-false)
        (je ,l0)
        ,@c1
        (jmp ,l1)
        ,l0
        ,@c2
        ,l1)))
   
  ;; Variable Expr Expr CEnv -> Asm
  (define (compile-tail-let x e0 e1 c)
    (let ((c0 (compile-e e0 c))
          (c1 (compile-tail-e e1 (cons x c))))
      `(,@c0
        (mov (offset rsp ,(- (add1 (length c)))) rax)
        ,@c1)))
   
  ;; Variable Expr Expr CEnv -> Asm
  (define (compile-let x e0 e1 c)
    (let ((c0 (compile-e e0 c))
          (c1 (compile-e e1 (cons x c))))
      `(,@c0
        (mov (offset rsp ,(- (add1 (length c)))) rax)
        ,@c1)))
   
  ;; Expr Expr CEnv -> Asm
  (define (compile-+ e0 e1 c)
    (let ((c1 (compile-e e1 c))
          (c0 (compile-e e0 (cons #f c))))
      `(,@c1
        ,@assert-integer
        (mov (offset rsp ,(- (add1 (length c)))) rax)
        ,@c0
        ,@assert-integer
        (add rax (offset rsp ,(- (add1 (length c))))))))
   
   
  (define (type-pred->mask p)
    (match p
      [(or 'box? 'cons? 'string? 'procedure?) result-type-mask]
      [_ imm-type-mask]))
   
  (define (type-pred->tag p)
    (match p
      ['box?       type-box]
      ['cons?      type-pair]
      ['string?    type-string]
      ['procedure? type-proc]
      ['integer?   imm-type-int]
      ['empty?     imm-type-empty]
      ['char?      imm-type-char]
      ['boolean?   imm-type-bool]))
   
  ;; Variable CEnv -> Natural
  (define (lookup x cenv)
    (match cenv
      ['() (error "undefined variable:" x)]
      [(cons y cenv)
       (match (eq? x y)
         [#t (length cenv)]
         [#f (lookup x cenv)])]))
   
  (define (assert-type p)
    `((mov rbx rax)
      (and rbx ,(type-pred->mask p))
      (cmp rbx ,(type-pred->tag p))
      (jne err)))
   
  (define assert-integer (assert-type 'integer?))
  (define assert-box     (assert-type 'box?))
  (define assert-pair    (assert-type 'cons?))
  (define assert-string  (assert-type 'string?))
  (define assert-char    (assert-type 'char?))
  (define assert-proc    (assert-type 'procedure?))
   
  ;; Asm
  (define assert-natural
    `(,@assert-integer
      (cmp rax -1)
      (jle err)))
   
  ;; Asm
  (define assert-integer-codepoint
    `((mov rbx rax)
      (and rbx ,imm-type-mask)
      (cmp rbx 0)
      (jne err)
      (cmp rax ,(arithmetic-shift -1 imm-shift))
      (jle err)
      (cmp rax ,(arithmetic-shift #x10FFFF imm-shift))
      (mov rbx rax)
      (sar rbx ,(+ 11 imm-shift))
      (cmp rbx #b11011)
      (je err)))
   
  ;; Symbol -> Label
  ;; Produce a symbol that is a valid Nasm label
  (define (symbol->label s)
    (string->symbol
     (string-append
      "label_"
      (list->string
       (map (λ (c)
              (if (or (char<=? #\a c #\z)
                      (char<=? #\A c #\Z)
                      (char<=? #\0 c #\9)
                      (memq c '(#\_ #\$ #\# #\@ #\~ #\. #\?)))
                  c
                  #\_))
           (string->list (symbol->string s))))
      "_"
      (number->string (eq-hash-code s) 16))))
   

We can verify that the compiler works for programs that use functions like before:

Examples

> (asm-interp
     (compile '(begin (define (f x)
                        (if (zero? x)
                            0
                            (add1 (call (fun f) (sub1 x)))))
                      (call (fun f) 10))))

10

But it also works when functions are put in lists:

Examples

> (asm-interp
     (compile '(begin (define (f x) x)
                      (call (car (cons (fun f) '())) 7))))

7

And functions that produce functions:

Examples

> (asm-interp
     (compile '(begin (define (f x) (fun h))
                      (define (h y) y)
                      (call (call (fun f) 5) 9))))

9