semdata.nim 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617
  1. #
  2. #
  3. # The Nim Compiler
  4. # (c) Copyright 2017 Andreas Rumpf
  5. #
  6. # See the file "copying.txt", included in this
  7. # distribution, for details about the copyright.
  8. #
  9. ## This module contains the data structures for the semantic checking phase.
  10. import tables
  11. when defined(nimPreviewSlimSystem):
  12. import std/assertions
  13. import
  14. intsets, options, ast, astalgo, msgs, idents, renderer,
  15. magicsys, vmdef, modulegraphs, lineinfos, sets, pathutils
  16. import ic / ic
  17. type
  18. TOptionEntry* = object # entries to put on a stack for pragma parsing
  19. options*: TOptions
  20. defaultCC*: TCallingConvention
  21. dynlib*: PLib
  22. notes*: TNoteKinds
  23. features*: set[Feature]
  24. otherPragmas*: PNode # every pragma can be pushed
  25. warningAsErrors*: TNoteKinds
  26. POptionEntry* = ref TOptionEntry
  27. PProcCon* = ref TProcCon
  28. TProcCon* {.acyclic.} = object # procedure context; also used for top-level
  29. # statements
  30. owner*: PSym # the symbol this context belongs to
  31. resultSym*: PSym # the result symbol (if we are in a proc)
  32. nestedLoopCounter*: int # whether we are in a loop or not
  33. nestedBlockCounter*: int # whether we are in a block or not
  34. breakInLoop*: bool # whether we are in a loop without block
  35. next*: PProcCon # used for stacking procedure contexts
  36. mappingExists*: bool
  37. mapping*: TIdTable
  38. caseContext*: seq[tuple[n: PNode, idx: int]]
  39. localBindStmts*: seq[PNode]
  40. TMatchedConcept* = object
  41. candidateType*: PType
  42. prev*: ptr TMatchedConcept
  43. depth*: int
  44. TInstantiationPair* = object
  45. genericSym*: PSym
  46. inst*: PInstantiation
  47. TExprFlag* = enum
  48. efLValue, efWantIterator, efWantIterable, efInTypeof,
  49. efNeedStatic,
  50. # Use this in contexts where a static value is mandatory
  51. efPreferStatic,
  52. # Use this in contexts where a static value could bring more
  53. # information, but it's not strictly mandatory. This may become
  54. # the default with implicit statics in the future.
  55. efPreferNilResult,
  56. # Use this if you want a certain result (e.g. static value),
  57. # but you don't want to trigger a hard error. For example,
  58. # you may be in position to supply a better error message
  59. # to the user.
  60. efWantStmt, efAllowStmt, efDetermineType, efExplain,
  61. efWantValue, efOperand, efNoSemCheck,
  62. efNoEvaluateGeneric, efInCall, efFromHlo, efNoSem2Check,
  63. efNoUndeclared, efIsDotCall, efCannotBeDotCall,
  64. # Use this if undeclared identifiers should not raise an error during
  65. # overload resolution.
  66. efNoDiagnostics,
  67. efTypeAllowed # typeAllowed will be called after
  68. efWantNoDefaults
  69. TExprFlags* = set[TExprFlag]
  70. ImportMode* = enum
  71. importAll, importSet, importExcept
  72. ImportedModule* = object
  73. m*: PSym
  74. case mode*: ImportMode
  75. of importAll: discard
  76. of importSet:
  77. imported*: IntSet # of PIdent.id
  78. of importExcept:
  79. exceptSet*: IntSet # of PIdent.id
  80. PContext* = ref TContext
  81. TContext* = object of TPassContext # a context represents the module
  82. # that is currently being compiled
  83. enforceVoidContext*: PType
  84. # for `if cond: stmt else: foo`, `foo` will be evaluated under
  85. # enforceVoidContext != nil
  86. voidType*: PType # for typeof(stmt)
  87. module*: PSym # the module sym belonging to the context
  88. currentScope*: PScope # current scope
  89. moduleScope*: PScope # scope for modules
  90. imports*: seq[ImportedModule] # scope for all imported symbols
  91. topLevelScope*: PScope # scope for all top-level symbols
  92. p*: PProcCon # procedure context
  93. intTypeCache*: array[-5..32, PType] # cache some common integer types
  94. # to avoid type allocations
  95. nilTypeCache*: PType
  96. matchedConcept*: ptr TMatchedConcept # the current concept being matched
  97. friendModules*: seq[PSym] # friend modules; may access private data;
  98. # this is used so that generic instantiations
  99. # can access private object fields
  100. instCounter*: int # to prevent endless instantiations
  101. templInstCounter*: ref int # gives every template instantiation a unique id
  102. inGenericContext*: int # > 0 if we are in a generic type
  103. inStaticContext*: int # > 0 if we are inside a static: block
  104. inUnrolledContext*: int # > 0 if we are unrolling a loop
  105. compilesContextId*: int # > 0 if we are in a ``compiles`` magic
  106. compilesContextIdGenerator*: int
  107. inGenericInst*: int # > 0 if we are instantiating a generic
  108. converters*: seq[PSym]
  109. patterns*: seq[PSym] # sequence of pattern matchers
  110. optionStack*: seq[POptionEntry]
  111. symMapping*: TIdTable # every gensym'ed symbol needs to be mapped
  112. # to some new symbol in a generic instantiation
  113. libs*: seq[PLib] # all libs used by this module
  114. semConstExpr*: proc (c: PContext, n: PNode; expectedType: PType = nil): PNode {.nimcall.} # for the pragmas
  115. semExpr*: proc (c: PContext, n: PNode, flags: TExprFlags = {}, expectedType: PType = nil): PNode {.nimcall.}
  116. semTryExpr*: proc (c: PContext, n: PNode, flags: TExprFlags = {}): PNode {.nimcall.}
  117. semTryConstExpr*: proc (c: PContext, n: PNode; expectedType: PType = nil): PNode {.nimcall.}
  118. computeRequiresInit*: proc (c: PContext, t: PType): bool {.nimcall.}
  119. hasUnresolvedArgs*: proc (c: PContext, n: PNode): bool
  120. semOperand*: proc (c: PContext, n: PNode, flags: TExprFlags = {}): PNode {.nimcall.}
  121. semConstBoolExpr*: proc (c: PContext, n: PNode): PNode {.nimcall.} # XXX bite the bullet
  122. semOverloadedCall*: proc (c: PContext, n, nOrig: PNode,
  123. filter: TSymKinds, flags: TExprFlags): PNode {.nimcall.}
  124. semTypeNode*: proc(c: PContext, n: PNode, prev: PType): PType {.nimcall.}
  125. semInferredLambda*: proc(c: PContext, pt: TIdTable, n: PNode): PNode
  126. semGenerateInstance*: proc (c: PContext, fn: PSym, pt: TIdTable,
  127. info: TLineInfo): PSym
  128. includedFiles*: IntSet # used to detect recursive include files
  129. pureEnumFields*: TStrTable # pure enum fields that can be used unambiguously
  130. userPragmas*: TStrTable
  131. evalContext*: PEvalContext
  132. unknownIdents*: IntSet # ids of all unknown identifiers to prevent
  133. # naming it multiple times
  134. generics*: seq[TInstantiationPair] # pending list of instantiated generics to compile
  135. topStmts*: int # counts the number of encountered top level statements
  136. lastGenericIdx*: int # used for the generics stack
  137. hloLoopDetector*: int # used to prevent endless loops in the HLO
  138. inParallelStmt*: int
  139. instTypeBoundOp*: proc (c: PContext; dc: PSym; t: PType; info: TLineInfo;
  140. op: TTypeAttachedOp; col: int): PSym {.nimcall.}
  141. cache*: IdentCache
  142. graph*: ModuleGraph
  143. signatures*: TStrTable
  144. recursiveDep*: string
  145. suggestionsMade*: bool
  146. isAmbiguous*: bool # little hack
  147. features*: set[Feature]
  148. inTypeContext*, inConceptDecl*: int
  149. unusedImports*: seq[(PSym, TLineInfo)]
  150. exportIndirections*: HashSet[(int, int)] # (module.id, symbol.id)
  151. importModuleMap*: Table[int, int] # (module.id, module.id)
  152. lastTLineInfo*: TLineInfo
  153. sideEffects*: Table[int, seq[(TLineInfo, PSym)]] # symbol.id index
  154. inUncheckedAssignSection*: int
  155. template config*(c: PContext): ConfigRef = c.graph.config
  156. proc getIntLitType*(c: PContext; literal: PNode): PType =
  157. # we cache some common integer literal types for performance:
  158. let value = literal.intVal
  159. if value >= low(c.intTypeCache) and value <= high(c.intTypeCache):
  160. result = c.intTypeCache[value.int]
  161. if result == nil:
  162. let ti = getSysType(c.graph, literal.info, tyInt)
  163. result = copyType(ti, nextTypeId(c.idgen), ti.owner)
  164. result.n = literal
  165. c.intTypeCache[value.int] = result
  166. else:
  167. let ti = getSysType(c.graph, literal.info, tyInt)
  168. result = copyType(ti, nextTypeId(c.idgen), ti.owner)
  169. result.n = literal
  170. proc setIntLitType*(c: PContext; result: PNode) =
  171. let i = result.intVal
  172. case c.config.target.intSize
  173. of 8: result.typ = getIntLitType(c, result)
  174. of 4:
  175. if i >= low(int32) and i <= high(int32):
  176. result.typ = getIntLitType(c, result)
  177. else:
  178. result.typ = getSysType(c.graph, result.info, tyInt64)
  179. of 2:
  180. if i >= low(int16) and i <= high(int16):
  181. result.typ = getIntLitType(c, result)
  182. elif i >= low(int32) and i <= high(int32):
  183. result.typ = getSysType(c.graph, result.info, tyInt32)
  184. else:
  185. result.typ = getSysType(c.graph, result.info, tyInt64)
  186. of 1:
  187. # 8 bit CPUs are insane ...
  188. if i >= low(int8) and i <= high(int8):
  189. result.typ = getIntLitType(c, result)
  190. elif i >= low(int16) and i <= high(int16):
  191. result.typ = getSysType(c.graph, result.info, tyInt16)
  192. elif i >= low(int32) and i <= high(int32):
  193. result.typ = getSysType(c.graph, result.info, tyInt32)
  194. else:
  195. result.typ = getSysType(c.graph, result.info, tyInt64)
  196. else:
  197. internalError(c.config, result.info, "invalid int size")
  198. proc makeInstPair*(s: PSym, inst: PInstantiation): TInstantiationPair =
  199. result.genericSym = s
  200. result.inst = inst
  201. proc filename*(c: PContext): string =
  202. # the module's filename
  203. return toFilename(c.config, FileIndex c.module.position)
  204. proc scopeDepth*(c: PContext): int {.inline.} =
  205. result = if c.currentScope != nil: c.currentScope.depthLevel
  206. else: 0
  207. proc getCurrOwner*(c: PContext): PSym =
  208. # owner stack (used for initializing the
  209. # owner field of syms)
  210. # the documentation comment always gets
  211. # assigned to the current owner
  212. result = c.graph.owners[^1]
  213. proc pushOwner*(c: PContext; owner: PSym) =
  214. c.graph.owners.add(owner)
  215. proc popOwner*(c: PContext) =
  216. if c.graph.owners.len > 0: setLen(c.graph.owners, c.graph.owners.len - 1)
  217. else: internalError(c.config, "popOwner")
  218. proc lastOptionEntry*(c: PContext): POptionEntry =
  219. result = c.optionStack[^1]
  220. proc popProcCon*(c: PContext) {.inline.} = c.p = c.p.next
  221. proc put*(p: PProcCon; key, val: PSym) =
  222. if not p.mappingExists:
  223. initIdTable(p.mapping)
  224. p.mappingExists = true
  225. #echo "put into table ", key.info
  226. p.mapping.idTablePut(key, val)
  227. proc get*(p: PProcCon; key: PSym): PSym =
  228. if not p.mappingExists: return nil
  229. result = PSym(p.mapping.idTableGet(key))
  230. proc getGenSym*(c: PContext; s: PSym): PSym =
  231. if sfGenSym notin s.flags: return s
  232. var it = c.p
  233. while it != nil:
  234. result = get(it, s)
  235. if result != nil:
  236. #echo "got from table ", result.name.s, " ", result.info
  237. return result
  238. it = it.next
  239. result = s
  240. proc considerGenSyms*(c: PContext; n: PNode) =
  241. if n == nil:
  242. discard "can happen for nkFormalParams/nkArgList"
  243. elif n.kind == nkSym:
  244. let s = getGenSym(c, n.sym)
  245. if n.sym != s:
  246. n.sym = s
  247. else:
  248. for i in 0..<n.safeLen:
  249. considerGenSyms(c, n[i])
  250. proc newOptionEntry*(conf: ConfigRef): POptionEntry =
  251. new(result)
  252. result.options = conf.options
  253. result.defaultCC = ccNimCall
  254. result.dynlib = nil
  255. result.notes = conf.notes
  256. result.warningAsErrors = conf.warningAsErrors
  257. proc pushOptionEntry*(c: PContext): POptionEntry =
  258. new(result)
  259. var prev = c.optionStack[^1]
  260. result.options = c.config.options
  261. result.defaultCC = prev.defaultCC
  262. result.dynlib = prev.dynlib
  263. result.notes = c.config.notes
  264. result.warningAsErrors = c.config.warningAsErrors
  265. result.features = c.features
  266. c.optionStack.add(result)
  267. proc popOptionEntry*(c: PContext) =
  268. c.config.options = c.optionStack[^1].options
  269. c.config.notes = c.optionStack[^1].notes
  270. c.config.warningAsErrors = c.optionStack[^1].warningAsErrors
  271. c.features = c.optionStack[^1].features
  272. c.optionStack.setLen(c.optionStack.len - 1)
  273. proc newContext*(graph: ModuleGraph; module: PSym): PContext =
  274. new(result)
  275. result.optionStack = @[newOptionEntry(graph.config)]
  276. result.libs = @[]
  277. result.module = module
  278. result.friendModules = @[module]
  279. result.converters = @[]
  280. result.patterns = @[]
  281. result.includedFiles = initIntSet()
  282. initStrTable(result.pureEnumFields)
  283. initStrTable(result.userPragmas)
  284. result.generics = @[]
  285. result.unknownIdents = initIntSet()
  286. result.cache = graph.cache
  287. result.graph = graph
  288. initStrTable(result.signatures)
  289. result.features = graph.config.features
  290. if graph.config.symbolFiles != disabledSf:
  291. let id = module.position
  292. assert graph.packed[id].status in {undefined, outdated}
  293. graph.packed[id].status = storing
  294. graph.packed[id].module = module
  295. initEncoder graph, module
  296. template packedRepr*(c): untyped = c.graph.packed[c.module.position].fromDisk
  297. template encoder*(c): untyped = c.graph.encoders[c.module.position]
  298. proc addIncludeFileDep*(c: PContext; f: FileIndex) =
  299. if c.config.symbolFiles != disabledSf:
  300. addIncludeFileDep(c.encoder, c.packedRepr, f)
  301. proc addImportFileDep*(c: PContext; f: FileIndex) =
  302. if c.config.symbolFiles != disabledSf:
  303. addImportFileDep(c.encoder, c.packedRepr, f)
  304. proc addPragmaComputation*(c: PContext; n: PNode) =
  305. if c.config.symbolFiles != disabledSf:
  306. addPragmaComputation(c.encoder, c.packedRepr, n)
  307. proc inclSym(sq: var seq[PSym], s: PSym): bool =
  308. for i in 0..<sq.len:
  309. if sq[i].id == s.id: return false
  310. sq.add s
  311. result = true
  312. proc addConverter*(c: PContext, conv: LazySym) =
  313. assert conv.sym != nil
  314. if inclSym(c.converters, conv.sym):
  315. add(c.graph.ifaces[c.module.position].converters, conv)
  316. proc addConverterDef*(c: PContext, conv: LazySym) =
  317. addConverter(c, conv)
  318. if c.config.symbolFiles != disabledSf:
  319. addConverter(c.encoder, c.packedRepr, conv.sym)
  320. proc addPureEnum*(c: PContext, e: LazySym) =
  321. assert e.sym != nil
  322. add(c.graph.ifaces[c.module.position].pureEnums, e)
  323. if c.config.symbolFiles != disabledSf:
  324. addPureEnum(c.encoder, c.packedRepr, e.sym)
  325. proc addPattern*(c: PContext, p: LazySym) =
  326. assert p.sym != nil
  327. if inclSym(c.patterns, p.sym):
  328. add(c.graph.ifaces[c.module.position].patterns, p)
  329. if c.config.symbolFiles != disabledSf:
  330. addTrmacro(c.encoder, c.packedRepr, p.sym)
  331. proc exportSym*(c: PContext; s: PSym) =
  332. strTableAdds(c.graph, c.module, s)
  333. if c.config.symbolFiles != disabledSf:
  334. addExported(c.encoder, c.packedRepr, s)
  335. proc reexportSym*(c: PContext; s: PSym) =
  336. strTableAdds(c.graph, c.module, s)
  337. if c.config.symbolFiles != disabledSf:
  338. addReexport(c.encoder, c.packedRepr, s)
  339. proc newLib*(kind: TLibKind): PLib =
  340. new(result)
  341. result.kind = kind #initObjectSet(result.syms)
  342. proc addToLib*(lib: PLib, sym: PSym) =
  343. #if sym.annex != nil and not isGenericRoutine(sym):
  344. # LocalError(sym.info, errInvalidPragma)
  345. sym.annex = lib
  346. proc newTypeS*(kind: TTypeKind, c: PContext): PType =
  347. result = newType(kind, nextTypeId(c.idgen), getCurrOwner(c))
  348. proc makePtrType*(owner: PSym, baseType: PType; idgen: IdGenerator): PType =
  349. result = newType(tyPtr, nextTypeId(idgen), owner)
  350. addSonSkipIntLit(result, baseType, idgen)
  351. proc makePtrType*(c: PContext, baseType: PType): PType =
  352. makePtrType(getCurrOwner(c), baseType, c.idgen)
  353. proc makeTypeWithModifier*(c: PContext,
  354. modifier: TTypeKind,
  355. baseType: PType): PType =
  356. assert modifier in {tyVar, tyLent, tyPtr, tyRef, tyStatic, tyTypeDesc}
  357. if modifier in {tyVar, tyLent, tyTypeDesc} and baseType.kind == modifier:
  358. result = baseType
  359. else:
  360. result = newTypeS(modifier, c)
  361. addSonSkipIntLit(result, baseType, c.idgen)
  362. proc makeVarType*(c: PContext, baseType: PType; kind = tyVar): PType =
  363. if baseType.kind == kind:
  364. result = baseType
  365. else:
  366. result = newTypeS(kind, c)
  367. addSonSkipIntLit(result, baseType, c.idgen)
  368. proc makeVarType*(owner: PSym, baseType: PType; idgen: IdGenerator; kind = tyVar): PType =
  369. if baseType.kind == kind:
  370. result = baseType
  371. else:
  372. result = newType(kind, nextTypeId(idgen), owner)
  373. addSonSkipIntLit(result, baseType, idgen)
  374. proc makeTypeSymNode*(c: PContext, typ: PType, info: TLineInfo): PNode =
  375. let typedesc = newTypeS(tyTypeDesc, c)
  376. incl typedesc.flags, tfCheckedForDestructor
  377. internalAssert(c.config, typ != nil)
  378. typedesc.addSonSkipIntLit(typ, c.idgen)
  379. let sym = newSym(skType, c.cache.idAnon, nextSymId(c.idgen), getCurrOwner(c), info,
  380. c.config.options).linkTo(typedesc)
  381. result = newSymNode(sym, info)
  382. proc makeTypeFromExpr*(c: PContext, n: PNode): PType =
  383. result = newTypeS(tyFromExpr, c)
  384. assert n != nil
  385. result.n = n
  386. proc newTypeWithSons*(owner: PSym, kind: TTypeKind, sons: seq[PType];
  387. idgen: IdGenerator): PType =
  388. result = newType(kind, nextTypeId(idgen), owner)
  389. result.sons = sons
  390. proc newTypeWithSons*(c: PContext, kind: TTypeKind,
  391. sons: seq[PType]): PType =
  392. result = newType(kind, nextTypeId(c.idgen), getCurrOwner(c))
  393. result.sons = sons
  394. proc makeStaticExpr*(c: PContext, n: PNode): PNode =
  395. result = newNodeI(nkStaticExpr, n.info)
  396. result.sons = @[n]
  397. result.typ = if n.typ != nil and n.typ.kind == tyStatic: n.typ
  398. else: newTypeWithSons(c, tyStatic, @[n.typ])
  399. proc makeAndType*(c: PContext, t1, t2: PType): PType =
  400. result = newTypeS(tyAnd, c)
  401. result.sons = @[t1, t2]
  402. propagateToOwner(result, t1)
  403. propagateToOwner(result, t2)
  404. result.flags.incl((t1.flags + t2.flags) * {tfHasStatic})
  405. result.flags.incl tfHasMeta
  406. proc makeOrType*(c: PContext, t1, t2: PType): PType =
  407. result = newTypeS(tyOr, c)
  408. if t1.kind != tyOr and t2.kind != tyOr:
  409. result.sons = @[t1, t2]
  410. else:
  411. template addOr(t1) =
  412. if t1.kind == tyOr:
  413. for x in t1.sons: result.rawAddSon x
  414. else:
  415. result.rawAddSon t1
  416. addOr(t1)
  417. addOr(t2)
  418. propagateToOwner(result, t1)
  419. propagateToOwner(result, t2)
  420. result.flags.incl((t1.flags + t2.flags) * {tfHasStatic})
  421. result.flags.incl tfHasMeta
  422. proc makeNotType*(c: PContext, t1: PType): PType =
  423. result = newTypeS(tyNot, c)
  424. result.sons = @[t1]
  425. propagateToOwner(result, t1)
  426. result.flags.incl(t1.flags * {tfHasStatic})
  427. result.flags.incl tfHasMeta
  428. proc nMinusOne(c: PContext; n: PNode): PNode =
  429. result = newTreeI(nkCall, n.info, newSymNode(getSysMagic(c.graph, n.info, "pred", mPred)), n)
  430. # Remember to fix the procs below this one when you make changes!
  431. proc makeRangeWithStaticExpr*(c: PContext, n: PNode): PType =
  432. let intType = getSysType(c.graph, n.info, tyInt)
  433. result = newTypeS(tyRange, c)
  434. result.sons = @[intType]
  435. if n.typ != nil and n.typ.n == nil:
  436. result.flags.incl tfUnresolved
  437. result.n = newTreeI(nkRange, n.info, newIntTypeNode(0, intType),
  438. makeStaticExpr(c, nMinusOne(c, n)))
  439. template rangeHasUnresolvedStatic*(t: PType): bool =
  440. tfUnresolved in t.flags
  441. proc errorType*(c: PContext): PType =
  442. ## creates a type representing an error state
  443. result = newTypeS(tyError, c)
  444. result.flags.incl tfCheckedForDestructor
  445. proc errorNode*(c: PContext, n: PNode): PNode =
  446. result = newNodeI(nkEmpty, n.info)
  447. result.typ = errorType(c)
  448. # These mimic localError
  449. template localErrorNode*(c: PContext, n: PNode, info: TLineInfo, msg: TMsgKind, arg: string): PNode =
  450. liMessage(c.config, info, msg, arg, doNothing, instLoc())
  451. errorNode(c, n)
  452. template localErrorNode*(c: PContext, n: PNode, info: TLineInfo, arg: string): PNode =
  453. liMessage(c.config, info, errGenerated, arg, doNothing, instLoc())
  454. errorNode(c, n)
  455. template localErrorNode*(c: PContext, n: PNode, msg: TMsgKind, arg: string): PNode =
  456. let n2 = n
  457. liMessage(c.config, n2.info, msg, arg, doNothing, instLoc())
  458. errorNode(c, n2)
  459. template localErrorNode*(c: PContext, n: PNode, arg: string): PNode =
  460. let n2 = n
  461. liMessage(c.config, n2.info, errGenerated, arg, doNothing, instLoc())
  462. errorNode(c, n2)
  463. proc fillTypeS*(dest: PType, kind: TTypeKind, c: PContext) =
  464. dest.kind = kind
  465. dest.owner = getCurrOwner(c)
  466. dest.size = - 1
  467. proc makeRangeType*(c: PContext; first, last: BiggestInt;
  468. info: TLineInfo; intType: PType = nil): PType =
  469. let intType = if intType != nil: intType else: getSysType(c.graph, info, tyInt)
  470. var n = newNodeI(nkRange, info)
  471. n.add newIntTypeNode(first, intType)
  472. n.add newIntTypeNode(last, intType)
  473. result = newTypeS(tyRange, c)
  474. result.n = n
  475. addSonSkipIntLit(result, intType, c.idgen) # basetype of range
  476. proc markIndirect*(c: PContext, s: PSym) {.inline.} =
  477. if s.kind in {skProc, skFunc, skConverter, skMethod, skIterator}:
  478. incl(s.flags, sfAddrTaken)
  479. # XXX add to 'c' for global analysis
  480. proc illFormedAst*(n: PNode; conf: ConfigRef) =
  481. globalError(conf, n.info, errIllFormedAstX, renderTree(n, {renderNoComments}))
  482. proc illFormedAstLocal*(n: PNode; conf: ConfigRef) =
  483. localError(conf, n.info, errIllFormedAstX, renderTree(n, {renderNoComments}))
  484. proc checkSonsLen*(n: PNode, length: int; conf: ConfigRef) =
  485. if n.len != length: illFormedAst(n, conf)
  486. proc checkMinSonsLen*(n: PNode, length: int; conf: ConfigRef) =
  487. if n.len < length: illFormedAst(n, conf)
  488. proc isTopLevel*(c: PContext): bool {.inline.} =
  489. result = c.currentScope.depthLevel <= 2
  490. proc isTopLevelInsideDeclaration*(c: PContext, sym: PSym): bool {.inline.} =
  491. # for routeKinds the scope isn't closed yet:
  492. c.currentScope.depthLevel <= 2 + ord(sym.kind in routineKinds)
  493. proc pushCaseContext*(c: PContext, caseNode: PNode) =
  494. c.p.caseContext.add((caseNode, 0))
  495. proc popCaseContext*(c: PContext) =
  496. discard pop(c.p.caseContext)
  497. proc setCaseContextIdx*(c: PContext, idx: int) =
  498. c.p.caseContext[^1].idx = idx
  499. template addExport*(c: PContext; s: PSym) =
  500. ## convenience to export a symbol from the current module
  501. addExport(c.graph, c.module, s)
  502. proc storeRodNode*(c: PContext, n: PNode) =
  503. if c.config.symbolFiles != disabledSf:
  504. toPackedNodeTopLevel(n, c.encoder, c.packedRepr)
  505. proc addToGenericProcCache*(c: PContext; s: PSym; inst: PInstantiation) =
  506. c.graph.procInstCache.mgetOrPut(s.itemId, @[]).add LazyInstantiation(module: c.module.position, inst: inst)
  507. if c.config.symbolFiles != disabledSf:
  508. storeInstantiation(c.encoder, c.packedRepr, s, inst)
  509. proc addToGenericCache*(c: PContext; s: PSym; inst: PType) =
  510. c.graph.typeInstCache.mgetOrPut(s.itemId, @[]).add LazyType(typ: inst)
  511. if c.config.symbolFiles != disabledSf:
  512. storeTypeInst(c.encoder, c.packedRepr, s, inst)
  513. proc sealRodFile*(c: PContext) =
  514. if c.config.symbolFiles != disabledSf:
  515. if c.graph.vm != nil:
  516. for (m, n) in PCtx(c.graph.vm).vmstateDiff:
  517. if m == c.module:
  518. addPragmaComputation(c, n)
  519. c.idgen.sealed = true # no further additions are allowed
  520. proc rememberExpansion*(c: PContext; info: TLineInfo; expandedSym: PSym) =
  521. ## Templates and macros are very special in Nim; these have
  522. ## inlining semantics so after semantic checking they leave no trace
  523. ## in the sem'checked AST. This is very bad for IDE-like tooling
  524. ## ("find all usages of this template" would not work). We need special
  525. ## logic to remember macro/template expansions. This is done here and
  526. ## delegated to the "rod" file mechanism.
  527. if c.config.symbolFiles != disabledSf:
  528. storeExpansion(c.encoder, c.packedRepr, info, expandedSym)