Changeset 6255 for trunk/doc/pslib/psLibSDRS.tex

Timestamp:

Jan 30, 2006, 2:55:46 PM (20 years ago)

Author:

Paul Price

Message:

psVector.n and psArray.n to be initially set to zero
psArrayAlloc and psArrayRealloc to initialise values

File:

• trunk/doc/pslib/psLibSDRS.tex (modified) (4 diffs)

trunk/doc/pslib/psLibSDRS.tex

@@ -1 @@
-%%% $Id: psLibSDRS.tex,v 1.377 2006-01-27 02:25:05 price Exp $
+%%% $Id: psLibSDRS.tex,v 1.378 2006-01-31 00:55:46 price Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -1884 +1884 @@
 %
 In these functions, \code{nalloc} is the number of elements to
-allocate.  For \code{psArrayAlloc}, the value of \code{psArray.n} is
-set to \code{nalloc}.  Users may choose to restrict the data range
+allocate.  In \code{psArrayAlloc}, the value of \code{psArray.n} is
+initially set to zero.  Users may choose to restrict the data range
 after the \code{psArrayAlloc} function is called.  For
 \code{psArrayRealloc}, if the value of \code{nalloc} is smaller than
@@ -1895 +1895 @@
 \code{array} is \code{NULL}, then \code{psArrayRealloc} must return an
 error.
+
+Since \code{psArray} stores pointers, values on the array shall always
+be initialised to \code{NULL} on \code{psArrayAlloc}.
+\code{psArrayRealloc} shall initialise values to \code{NULL} where the
+array has been grown.
 
 \begin{prototype}
@@ -3399 +3404 @@
 In these functions, \code{nalloc} is the number of elements to
 allocate.  For \code{psVectorAlloc}, the value of \code{psVector.n} is
-set to \code{nalloc}.  Users may choose to restrict the data range
+initially set to zero.  Users may choose to restrict the data range
 after the \code{psVectorAlloc} function is called.  For
 \code{psVectorRealloc}, if the value of \code{nalloc} is smaller than