mirrors/Nim
1
0
Fork 0
mirror of https://github.com/nim-lang/Nim.git synced 2026-01-09 22:43:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

add docs to copyNimNode and copyNimTree (#20357)

Browse Source 
* add docs to copyNimNode and copyNimTree

* Apply suggestions from code review

Co-authored-by: Clay Sweetser <Varriount@users.noreply.github.com>

Co-authored-by: Clay Sweetser <Varriount@users.noreply.github.com>
This commit is contained in:
ringabout
2022-09-16 12:35:44 +08:00
committed by GitHub
parent c7ee4ab509
commit d44b547144
1 changed files with 25 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
lib/core/macros.nim
View File

@@ -394,8 +394,31 @@ proc newNimNode*(kind: NimNodeKind,
## produced code crashes. You should ensure that it is set to a node that
## you are transforming.
proc copyNimNode*(n: NimNode): NimNode {.magic: "NCopyNimNode", noSideEffect.}
proc copyNimTree*(n: NimNode): NimNode {.magic: "NCopyNimTree", noSideEffect.}
proc copyNimNode*(n: NimNode): NimNode {.magic: "NCopyNimNode", noSideEffect.} =
## Creates a new AST node by copying the node `n`. Note that unlike `copyNimTree`,
## child nodes of `n` are not copied.
runnableExamples:
macro foo(x: typed) =
var s = copyNimNode(x)
doAssert s.len == 0
doAssert s.kind == nnkStmtList
foo:
let x = 12
echo x
proc copyNimTree*(n: NimNode): NimNode {.magic: "NCopyNimTree", noSideEffect.} =
## Creates a new AST node by recursively copying the node `n`. Note that
## unlike `copyNimNode`, this copies `n`, the children of `n`, etc.
runnableExamples:
macro foo(x: typed) =
var s = copyNimTree(x)
doAssert s.len == 2
doAssert s.kind == nnkStmtList
foo:
let x = 12
echo x
proc error*(msg: string, n: NimNode = nil) {.magic: "NError", benign.}
## Writes an error message at compile time. The optional `n: NimNode`