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

Added safeAdd documentation

Browse source
This commit is contained in:
apense 2015-07-06 15:47:23 -04:00
commit 30737ea34b
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:
# XXX: make these the default (or implement the NilObject optimization)
proc safeAdd*[T](x: var seq[T], y: T) {.noSideEffect.} =
## Add `y` to `x` unless `x` is not yet initialized; in that case, `x`
## becomes `@[y]`
if x == nil: x = @[y]
else: x.add(y)
proc safeAdd*(x: var string, y: char) =
## Add `y` to `x`. If `x` is `nil` it is initialized to `""`
if x == nil: x = ""
x.add(y)
proc safeAdd*(x: var string, y: string) =
## Add `y` to `x` unless `x` is not yet initalized; in that case, `x`
## becomes `y`
if x == nil: x = y
else: x.add(y)