summary refs log tree commit diff stats
path: root/lib/pure/volatile.nim
blob: a38247c7db1dba7f6ca9b0a5503325a855e47ec1 (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
31
32
33
34
#
#
#            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.

proc volatileLoad*[T](src: ptr T): T {.inline, noinit.} =
  ## Generates a volatile load of the value stored in the container `src`.
  ## Note that this only effects code generation on `C` like backends.
  when nimvm:
    result = src[]
  else:
    when defined(js):
      result = src[]
    else:
      {.emit: [result, " = (*(", typeof(src[]), " volatile*)", src, ");"].}

proc volatileStore*[T](dest: ptr T, val: T) {.inline.} =
  ## Generates a volatile store into the container `dest` of the value
  ## `val`. Note that this only effects code generation on `C` like
  ## backends.
  when nimvm:
    dest[] = val
  else:
    when defined(js):
      dest[] = val
    else:
      {.emit: ["*((", typeof(dest[]), " volatile*)(", dest, ")) = ", val, ";"].}