[Numerics] Deprecate GeneralMatrix::nRowsAndStruct

include/cantera/clib/ctmatlab.h

@@ -0,0 +1,8 @@
+#include "ct.h"
+#include "ctfunc.h"
+#include "ctmultiphase.h"
+#include "ctonedim.h"
+#include "ctreactor.h"
+#include "ctrpath.h"
+#include "ctsurf.h"
+#include "ctxml.h"

include/cantera/numerics/BandMatrix.h

@@ -131,6 +131,7 @@ public:
      *         istruct[0] = kl
      *         istruct[1] = ku
      * @returns the number of rows and columns in the matrix.
+     * @deprecated Unused. To be removed after Cantera 2.3.
      */
     virtual size_t nRowsAndStruct(size_t* const iStruct = 0) const;
 

include/cantera/numerics/GeneralMatrix.h

@@ -115,6 +115,7 @@ public:
      * @param iStruct OUTPUT Pointer to a vector of ints that describe the
      *     structure of the matrix.
      * @returns the number of rows and columns in the matrix.
+     * @deprecated Unused. To be removed after Cantera 2.3.
      */
     virtual size_t nRowsAndStruct(size_t* const iStruct = 0) const = 0;
 

include/cantera/numerics/SquareMatrix.h

@@ -95,6 +95,7 @@ public:
      *    structure of the matrix. not used
      *
      * @returns the number of rows and columns in the matrix.
+     * @deprecated Unused. To be removed after Cantera 2.3.
      */
     size_t nRowsAndStruct(size_t* const iStruct = 0) const;
 

src/numerics/BandMatrix.cpp

@@ -173,6 +173,8 @@ size_t BandMatrix::nRows() const
 
 size_t BandMatrix::nRowsAndStruct(size_t* const iStruct) const
 {
+    warn_deprecated("BandMatrix::nRowsAndStruct",
+                    "To be removed after Cantera 2.3.");
     if (iStruct) {
         iStruct[0] = m_kl;
         iStruct[1] = m_ku;

src/numerics/SquareMatrix.cpp

@@ -320,6 +320,8 @@ size_t SquareMatrix::nRows() const
 
 size_t SquareMatrix::nRowsAndStruct(size_t* const iStruct) const
 {
+    warn_deprecated("SquareMatrix::nRowsAndStruct",
+                    "To be removed after Cantera 2.3.");
     return m_nrows;
 }