lineinfos

nimony/src/lib/lineinfos.nim

• type PackedLineInfo = distinct uint32
• type FileId = distinct uint32
• func ==(a: FileId; b: FileId): bool
• func ==(a: PackedLineInfo; b: PackedLineInfo): bool
• func hash(a: FileId): uint64
• func hash(a: PackedLineInfo): uint64

• type LineInfoUnpacked = object
    file: FileId
    line: int32
    col: int32
    comment: uint32

• type LineInfoManager = object
    aside: seq

• const NoLineInfo: PackedLineInfo
• const NoFile: FileId
• proc isValid(x: PackedLineInfo): bool
• proc isValid(x: FileId): bool
• proc pack(m: var LineInfoManager; file: FileId; line: int32; col: int32): PackedLineInfo
• proc packWithComment(m: var LineInfoManager; file: FileId; line: int32; col: int32; comment: uint32): PackedLineInfo

  Like pack but also attaches a #comment# to the position. Comment-bearing infos always use the aside path (the inline encoding has no room for a comment id). comment == 0 means no comment — callers should use the plain pack in that case.

• proc isPayload(i: PackedLineInfo): bool
• proc unpack(m: LineInfoManager; info: PackedLineInfo): LineInfoUnpacked
• proc stripComment(m: var LineInfoManager; info: PackedLineInfo): PackedLineInfo

  Return the same file/line/col but with no comment attached. Useful when propagating a parent's info to children for relative-position math: comments are decorations on a single token, not inherited by descendants.

• proc getPayload(i: PackedLineInfo): uint32
• proc toPayload(val: uint32): PackedLineInfo
• proc getFileId(m: LineInfoManager; i: PackedLineInfo): FileId
• proc memSize(m: LineInfoManager): int64