jyapayne/Nim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #3073 from apense/patch-12

Browse source 
Added safeAdd documentation
This commit is contained in:
Andreas Rumpf 2015-07-11 13:23:07 +02:00
commit 459793ca4c
1 changed files with 5 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
lib/system.nim
View file

@ -3286,14 +3286,19 @@ when declared(initDebugger):
when hasAlloc: when hasAlloc:
# XXX: make these the default (or implement the NilObject optimization) # XXX: make these the default (or implement the NilObject optimization)
proc safeAdd*[T](x: var seq[T], y: T) {.noSideEffect.} = proc safeAdd*[T](x: var seq[T], y: T) {.noSideEffect.} =
## Adds ``y`` to ``x`` unless ``x`` is not yet initialized; in that case,
## ``x`` becomes ``@[y]``
if x == nil: x = @[y] if x == nil: x = @[y]
else: x.add(y) else: x.add(y)
proc safeAdd*(x: var string, y: char) = proc safeAdd*(x: var string, y: char) =
## Adds ``y`` to ``x``. If ``x`` is ``nil`` it is initialized to ``""``
if x == nil: x = "" if x == nil: x = ""
x.add(y) x.add(y)
proc safeAdd*(x: var string, y: string) = proc safeAdd*(x: var string, y: string) =
## Adds ``y`` to ``x`` unless ``x`` is not yet initalized; in that case, ``x``
## becomes ``y``
if x == nil: x = y if x == nil: x = y
else: x.add(y) else: x.add(y)