summary refs log tree commit diff stats
path: root/lib/pure/volatile.nim
blob: b3705a19994d21210169e7c3afc105abe67a6e84 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
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, ";"].}