# A list links up multiple objects together to make them easier to manage. # # The objects must be of the same type. If you want to store multiple types in # a single list, use an exclusive-container. container list:_elem [ value:_elem next:address:list:_elem ] def push x:_elem, in:address:list:_elem -> result:address:list:_elem [ local-scope load-ingredients result <- new {(list _elem): type} *result <- merge x, in ] def first in:address:list:_elem -> result:_elem [ local-scope load-ingredients result <- get *in, value:offset ] def rest in:address:list:_elem -> result:address:list:_elem/contained-in:in [ local-scope load-ingredients result <- get *in, next:offset ] scenario list-handling [ run [ local-scope x:address:list:number <- push 3, 0 x <- push 4, x x <- push 5, x 10:number/raw <- first x x <- rest x 11:number/raw <- first x x <- rest x 12:number/raw <- first x 20:address:list:number/raw <- rest x ] memory-should-contain [ 10 <- 5 11 <- 4 12 <- 3 20 <- 0 # nothing left ] ] def length l:address:list:_elem -> result:number [ local-scope load-ingredients return-unless l, 0 rest:address:list:_elem <- rest l length-of-rest:number <- length rest result <- add length-of-rest, 1 ] # insert 'x' after 'in' def insert x:_elem, in:address:list:_elem -> in:address:list:_elem [ local-scope load-ingredients new-node:address:list:_elem <- new {(list _elem): type} *new-node <- put *new-node, value:offset, x next-node:address:list:_elem <- get *in, next:offset *in <- put *in, next:offset, new-node *new-node <- put *new-node, next:offset, next-node ] scenario inserting-into-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- push 4, list list <- push 5, list list2:address:list:character <- rest list # inside list list2 <- insert 6, list2 # check structure list2 <- copy list 10:character/raw <- first list2 list2 <- rest list2 11:character/raw <- first list2 list2 <- rest list2 12:character/raw <- first list2 list2 <- rest list2 13:character/raw <- first list2 ] memory-should-contain [ 10 <- 5 # scanning next 11 <- 4 12 <- 6 # inserted element 13 <- 3 ] ] scenario inserting-at-end-of-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- push 4, list list <- push 5, list list2:address:list:character <- rest list # inside list list2 <- rest list2 # now at end of list list2 <- insert 6, list2 # check structure like before list2 <- copy list 10:character/raw <- first list2 list2 <- rest list2 11:character/raw <- first list2 list2 <- rest list2 12:character/raw <- first list2 list2 <- rest list2 13:character/raw <- first list2 ] memory-should-contain [ 10 <- 5 # scanning next 11 <- 4 12 <- 3 13 <- 6 # inserted element ] ] scenario inserting-after-start-of-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- push 4, list list <- push 5, list list <- insert 6, list # check structure like before list2:address:list:character <- copy list 10:character/raw <- first list2 list2 <- rest list2 11:character/raw <- first list2 list2 <- rest list2 12:character/raw <- first list2 list2 <- rest list2 13:character/raw <- first list2 ] memory-should-contain [ 10 <- 5 # scanning next 11 <- 6 # inserted element 12 <- 4 13 <- 3 ] ] # remove 'x' from its surrounding list 'in' # # Returns null if and only if list is empty. Beware: in that case any other # pointers to the head are now invalid. def remove x:address:list:_elem/contained-in:in, in:address:list:_elem -> in:address:list:_elem [ local-scope load-ingredients # if 'x' is null, return return-unless x next-node:address:list:_elem <- rest x # clear next pointer of 'x' *x <- put *x, next:offset, 0 # if 'x' is at the head of 'in', return the new head at-head?:boolean <- equal x, in return-if at-head?, next-node # compute prev-node prev-node:address:list:_elem <- copy in curr:address:list:_elem <- rest prev-node { return-unless curr found?:boolean <- equal curr, x break-if found? prev-node <- copy curr curr <- rest curr } # set its next pointer to skip 'x' *prev-node <- put *prev-node, next:offset, next-node ] scenario removing-from-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- push 4, list list <- push 5, list list2:address:list:character <- rest list # second element list <- remove list2, list 10:boolean/raw <- equal list2, 0 # check structure like before list2 <- copy list 11:character/raw <- first list2 list2 <- rest list2 12:character/raw <- first list2 20:address:list:character/raw <- rest list2 ] memory-should-contain [ 10 <- 0 # remove returned non-null 11 <- 5 # scanning next, skipping deleted element 12 <- 3 20 <- 0 # no more elements ] ] scenario removing-from-start-of-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- push 4, list list <- push 5, list list <- remove list, list # check structure like before list2:address:list:character <- copy list 10:character/raw <- first list2 list2 <- rest list2 11:character/raw <- first list2 20:address:list:character/raw <- rest list2 ] memory-should-contain [ 10 <- 4 # scanning next, skipping deleted element 11 <- 3 20 <- 0 # no more elements ] ] scenario removing-from-end-of-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- push 4, list list <- push 5, list # delete last element list2:address:list:character <- rest list list2 <- rest list2 list <- remove list2, list 10:boolean/raw <- equal list2, 0 # check structure like before list2 <- copy list 11:character/raw <- first list2 list2 <- rest list2 12:character/raw <- first list2 20:address:list:character/raw <- rest list2 ] memory-should-contain [ 10 <- 0 # remove returned non-null 11 <- 5 # scanning next, skipping deleted element 12 <- 4 20 <- 0 # no more elements ] ] scenario removing-from-singleton-list [ run [ local-scope list:address:list:character <- push 3, 0 list <- remove list, list 1:number/raw <- copy list ] memory-should-contain [ 1 <- 0 # back to an empty list ] ] def to-text in:address:list:_elem -> result:address:array:character [ local-scope load-ingredients buf:address:buffer <- new-buffer 80 buf <- to-buffer in, buf result <- buffer-to-array buf ] # variant of 'to-text' which stops printing