std/byaddr => std/decls (#13847)

1 files changed, 19 insertions, 0 deletions

diff --git a/lib/std/decls.nim b/lib/std/decls.nim
new file mode 100644
index 000000000..dd7d19da7
--- /dev/null
+++ b/lib/std/decls.nim
@@ -0,0 +1,19 @@
+# see `semLowerLetVarCustomPragma` for compiler support that enables these
+# lowerings
+
+template byaddr*(lhs, typ, ex) =
+  ## Allows a syntax for lvalue reference, exact analog to
+  ## `auto& a = ex;` in C++
+  runnableExamples:
+    var s = @[10,11,12]
+    var a {.byaddr.} = s[0]
+    a+=100
+    doAssert s == @[110,11,12]
+    doAssert a is int
+    var b {.byaddr.}: int = s[0]
+    doAssert a.addr == b.addr
+  when typ is typeof(nil):
+    let tmp = addr(ex)
+  else:
+    let tmp: ptr typ = addr(ex)
+  template lhs: untyped = tmp[]