Add volatile load/store (#5263)

Adds volatile load/store capability to the impure part of the standard
library.  Note that this currently only supports numerical types.

Should resolve https://github.com/nim-lang/Nim/issues/3382

1 files changed, 30 insertions, 0 deletions

diff --git a/lib/pure/volatile.nim b/lib/pure/volatile.nim
new file mode 100644
index 000000000..b3705a199
--- /dev/null
+++ b/lib/pure/volatile.nim
@@ -0,0 +1,30 @@
+#
+#
+#            Nim's Runtime Library
+#        (c) Copyright 2017 Jeff Ciesielski
+#
+#    See the file "copying.txt", included in this
+#    distribution, for details about the copyright.
+#
+
+## This module contains code for generating volatile loads and stores,
+## which are useful in embedded and systems programming.
+
+template volatileLoad*[T](src: ptr T): T =
+  ## Generates a volatile load of the value stored in the container `src`.
+  ## Note that this only effects code generation on `C` like backends
+  when defined(js):
+    src[]
+  else:
+    var res: T
+    {.emit: [res, " = (*(", type(src[]), " volatile*)", src, ");"].}
+    res
+
+template volatileStore*[T](dest: ptr T, val: T) =
+  ## Generates a volatile store into the container `dest` of the value
+  ## `val`. Note that this only effects code generation on `C` like
+  ## backends
+  when defined(js):
+    dest[] = val
+  else:
+    {.emit: ["*((", type(dest[]), " volatile*)(", dest, ")) = ", val, ";"].}