.ifndef INCLUDE_UTILITY
INCLUDE_UTILITY = 1

.macpack longbranch     ; jeq, jge...
.macpack generic        ; bge, add, sub

.feature string_escapes
.feature underline_in_numbers


;;********************************************************************************
;; @macro Update a byte in memory using a mask
;; @param addr       Address of the byte to update
;; @param value      New value
;; @param mask       Mask of the bits to affect by the new value
;; @details
;;   xor #value with addr -> only bits that need to flip are 1
;;   and result with #mask -> only selected bits that need to flip stay 1
;;   xor result with addr -> flips selected bits
;;********************************************************************************
.macro MaskedWrite addr,value,mask
    lda value
    eor addr
    and mask
    eor addr
    sta addr
.endmacro


;;********************************************************************************
;; @macro Jump to the subroutine and let the routine return at another location
;; @details
;;  By using a indirect address `(addr)` and no ret_val, this macro behaves
;;  like an indirect version of jsr.
;; @param addr       Target of the jump (can be: `addr`, `(addr)` or `{(addr,x)}`
;; @param ret_addr   Return address (optional)
;; @details
;;********************************************************************************
.macro JsrIndirect addr,ret_addr
    ; -1 because rts increments it
    .if .blank(ret_addr)
    lda #<(:+ - 1)
    pha
    lda #>(:+ - 1)
    pha
    .else
    lda #<(ret_addr -1)
    pha
    lda #>(ret_addr -1)
    pha
    .endif
    jmp addr
.if .blank(ret_addr)
:
.endif
.endmacro





_n_genlabel .set 0
;;********************************************************************************
;; @macro Generate a unique label
;;********************************************************************************
.macro GenLabel name
    .ident(.sprintf("generated_label%04X", _n_genlabel))
    _n_genlabel .set _n_genlabel + 1
.endmacro

;;********************************************************************************
;; @macro Export labels with a prefix
;; @details
;;  Equivalent to:
;;  .export prefix_l1:=l1
;;  .export prefix_l2:=l2
;;  ...
;;********************************************************************************
.macro Export prefix,l1,l2,l3,l4,l5,l6,l7,l8
    .if .blank(l1)
        .exitmacro
    .endif
    ; .out .sprintf("Exporting %s as %s_%s", .string(l1), .string(prefix), .string(l1))
    .export .ident(.sprintf("%s_%s", .string(prefix), .string(l1))):=l1
    Export prefix,l2,l3,l4,l5,l6,l7,l8
.endmacro
.macro ExportZp prefix,l1,l2,l3,l4,l5,l6,l7,l8
    .if .blank(l1)
        .exitmacro
    .endif
    ; .out .sprintf("Exporting (zp) %s as %s_%s", .string(l1), .string(prefix), .string(l1))
    .exportzp .ident(.sprintf("%s_%s", .string(prefix), .string(l1))):=l1
    ExportZp prefix,l2,l3,l4,l5,l6,l7,l8
.endmacro

;;********************************************************************************
;; @macro Import labels and remove prefix
;; @details
;;  Equivalent to:
;;      .import prefix_l1
;;      .import prefix_l2
;;      ...
;;      l1 = prefix_l1
;;      l2 = prefix_l2
;;      ...
;;  Use in a scope to have the lX available as scope::lX
;;********************************************************************************
.macro Import prefix,l1,l2,l3,l4,l5,l6,l7,l8
    .if .blank(l1)
        .exitmacro
    .endif
    ; .out .sprintf("Importing %s_%s as %s", .string(prefix), .string(l1), .string(l1))
    .import .ident(.sprintf("%s_%s", .string(prefix), .string(l1))):absolute
    .ident(.sprintf("%s", .string(l1))) = .ident(.sprintf("%s_%s", .string(prefix), .string(l1)))
    Import prefix,l2,l3,l4,l5,l6,l7,l8
.endmacro
.macro ImportZp prefix,l1,l2,l3,l4,l5,l6,l7,l8
    .if .blank(l1)
        .exitmacro
    .endif
    ; .out .sprintf("Importing (zp) %s_%s as %s", .string(prefix), .string(l1), .string(l1))
    .importzp .ident(.sprintf("%s_%s", .string(prefix), .string(l1))):zeropage
    .ident(.sprintf("%s", .string(l1))) = .ident(.sprintf("%s_%s", .string(prefix), .string(l1)))
    ImportZp prefix,l2,l3,l4,l5,l6,l7,l8
.endmacro
.endif