Changeset 6255

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

Location:

trunk/doc/pslib

Files:

• ChangeLogSDRS.tex (modified) (2 diffs)
• psLibSDRS.tex (modified) (4 diffs)

trunk/doc/pslib/ChangeLogSDRS.tex

@@ -1 @@
-%%% $Id: ChangeLogSDRS.tex,v 1.189 2006-01-27 02:25:00 price Exp $
+%%% $Id: ChangeLogSDRS.tex,v 1.190 2006-01-31 00:55:42 price Exp $
 
 \subsection{Changes from version 00 to version 01}
@@ -843 +843 @@
 \item change \code{psFitsReadTable()}'s \code{fits} param to be \code{const} 
 \item Added S8,S16,U8,U16,U32 to \code{psDataType} (bug 579).
-\end{itemize}
+\item \code{psVector.n} and \code{psArray.n} to be initially set to zero
+\item \code{psArrayAlloc} and \code{psArrayRealloc} to initialise values
+\end{itemize}

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