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

Timestamp:

Oct 24, 2006, 12:29:53 PM (20 years ago)

Author:

Paul Price

Message:

psVectorAlloc and psArrayAlloc set length to that requested;
psVectorAllocEmpty and psArrayAllocEmpty set the length to zero.

File:

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

trunk/doc/pslib/psLibSDRS.tex

@@ -1 @@
-%%% $Id: psLibSDRS.tex,v 1.436 2006-10-24 21:24:08 price Exp $
+%%% $Id: psLibSDRS.tex,v 1.437 2006-10-24 22:29:53 price Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -2033 +2033 @@
 \begin{prototype}
 psArray *psArrayAlloc(long nalloc);
+psArray *psArrayAllocEmpty(long nalloc);
 psArray *psArrayRealloc(psArray *array, long nalloc);
 \end{prototype}
@@ -2038 +2039 @@
 In these functions, \code{nalloc} is the number of elements to
 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
-the current value of \code{psArray.n}, then \code{psArray.n} is set to
-\code{nalloc}, the array is adjusted down to match \code{nalloc}, and
-the extra elements are dropped and freed if necesitated by the
-reference counter.  If \code{nalloc} is larger than the current value
-of \code{psArray.n}, \code{psArray.n} is left intact.  If the value of
-\code{array} is \code{NULL}, then \code{psArrayRealloc} must return an
-error.
+initially set to the number of allocated elements; in
+\code{psArrayAllocEmpty}, 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 the current value of
+\code{psArray.n}, then \code{psArray.n} is set to \code{nalloc}, the
+array is adjusted down to match \code{nalloc}, and the extra elements
+are dropped and freed if necesitated by the reference counter.  If
+\code{nalloc} is larger than the current value of \code{psArray.n},
+\code{psArray.n} is left intact.  If the value of \code{array} is
+\code{NULL}, then \code{psArrayRealloc} must return an error.
 
 Since \code{psArray} stores pointers, values on the array shall always