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

Clarifies wording of newSeq proc docstrings.

Browse source
This commit is contained in:
Grzegorz Adam Hankiewicz 2013-11-22 22:54:24 +01:00
commit 936c71df70
1 changed files with 8 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

16
lib/system.nim
View file

@ -374,10 +374,10 @@ proc newSeq*[T](s: var seq[T], len: int) {.magic: "NewSeq", noSideEffect.}
## This is equivalent to ``s = @[]; setlen(s, len)``, but more ## This is equivalent to ``s = @[]; setlen(s, len)``, but more
## efficient since no reallocation is needed. ## efficient since no reallocation is needed.
## ##
## Note that the sequence will be filled with uninitialized entries, which ## Note that the sequence will be filled with zeroed entries, which can be a
## can be a problem for sequences containing strings. After the creation of ## problem for sequences containing strings since their value will be
## the sequence you should assign entries to the sequence instead of adding ## ``nil``. After the creation of the sequence you should assign entries to
## them. Example: ## the sequence instead of adding them. Example:
## ##
## .. code-block:: nimrod ## .. code-block:: nimrod
## var inputStrings : seq[string] ## var inputStrings : seq[string]
@ -390,10 +390,10 @@ proc newSeq*[T](s: var seq[T], len: int) {.magic: "NewSeq", noSideEffect.}
proc newSeq*[T](len = 0): seq[T] = proc newSeq*[T](len = 0): seq[T] =
## creates a new sequence of type ``seq[T]`` with length ``len``. ## creates a new sequence of type ``seq[T]`` with length ``len``.
## ##
## Note that the sequence will be filled with uninitialized entries, which ## Note that the sequence will be filled with zeroed entries, which can be a
## can be a problem for sequences containing strings. After the creation of ## problem for sequences containing strings since their value will be
## the sequence you should assign entries to the sequence instead of adding ## ``nil``. After the creation of the sequence you should assign entries to
## them. Example: ## the sequence instead of adding them. Example:
## ##
## .. code-block:: nimrod ## .. code-block:: nimrod
## var inputStrings = newSeq[string](3) ## var inputStrings = newSeq[string](3)