dolphindb 2.0.906 → 2.0.908

package/docs.en.json

@@ -14451,9 +14451,23 @@
                         "value": [
                             "`name` is a string indicating the name of the reactive state engine. It is the only identifier of the reactive state engine. It can have letter, number and \"_\". It must start with a letter.",
                             "",
-                            "`metrics` is metacode specifying the formulas for calculation. The formulas should use vector functions instead of aggregate functions. For more information about metacode please refer to  :doc:`/Objects/Metaprogramming`. To use a user-defined function in the reactive state engine, please add \"@state\" to declare it before the definition.",
+                            "`metrics` is metacode specifying the formulas for calculation. The formulas should use vector functions instead of aggregate functions. For more information about metacode please refer to  :doc:`/Objects/Metaprogramming`. To use a user-defined function in the reactive state engine, please note:",
                             "",
-                            "The following state functions in DolphinDB's reactive state engine has been optimized. Currently, unoptimized state functions are not supported by this engine. And aggregate functions should be avoid.",
+                            "1. Add \"@state\" to declare the function before the definition. For state functions, only assignment statements and return statements are supported.",
+                            "",
+                            "2. If the rvalue of an assignment statement is a function that returns multiple values, the values must be assigned to variables at the same time. In the following example, the user-defined state function references linearTimeTrend, which returns two values:",
+                            "",
+                            ".. code-block:: console",
+                            "",
+                            "   $ @state",
+                            "   $ def forcast2(S, N){",
+                            "   $       linearregIntercept, linearregSlope = linearTimeTrend(S, N)",
+                            "   $       return (N - 1) * linearregSlope + linearregIntercept",
+                            "   $ }",
+                            "",
+                            ".. _dummyTable_rs:",
+                            "",
+                            "The following state functions in DolphinDB's reactive state engine has been optimized. Currently, unoptimized state functions are not supported by this engine, and aggregate functions should be avoid.",
                             "",
                             "* cumulative function: cumavg, cumsum, cumprod, cumcount, cummin, cummax, cumvar, cumvarp, cumstd, cumstdp, cumcorr, cumcovar, cumbeta, cumwsum, cumwavg, cumfirstNot, cumlastNot, cummed, cumpercentile ",
                             "* moving function: ema, mavg, msum, mcount, mprod, mvar, mvarp, mstd, mstdp, mskew, mkurtosis, mmin, mmax, mimin, mimax, mmed, mpercentile, mrank, mcorr, mcovar, mbeta, mwsum, mwavg, mmad, mfirst, mlast, mslr, tmove, tmfirst, tmlast, tmsum, tmavg, tmcount, tmvar, tmvarp, tmstd, tmstdp, tmprod, tmskew, tmkurtosis, tmmin, tmmax, tmmed, tmpercentile, tmrank, tmcovar, tmbeta, tmcorr, tmwavg, tmwsum, tmoving, moving, sma,wma, dema, tema, trima, linearTimeTrend, talib, t3, ma",