Add separate state length property

Author: kgryte

lib/node_modules/@stdlib/random/base/mt19937/README.md

@@ -170,9 +170,18 @@ r = mt19937();
 // ...
 ```
 
+#### mt19937.STATE_LENGTH
+
+Length of generator state.
+
+```javascript
+var len = mt19937.STATE_LENGTH;
+// returns <number>
+```
+
 #### mt19937.STATE_SIZE
 
-Size of generator state.
+Size (in bytes) of generator state.
 
 ```javascript
 var sz = mt19937.STATE_SIZE;

lib/node_modules/@stdlib/random/base/mt19937/docs/repl.txt

@@ -129,8 +129,16 @@
     <number>
 
 
+{{alias}}.STATE_LENGTH
+    Length of generator state.
+
+    Examples
+    --------
+    > var len = {{alias}}.STATE_LENGTH;
+
+
 {{alias}}.STATE_SIZE
-    Size of generator state.
+    Size (in bytes) of generator state.
 
     Examples
     --------

lib/node_modules/@stdlib/random/base/mt19937/lib/factory.js

@@ -415,7 +415,8 @@ function factory( options ) {
 		'get': getState,
 		'set': setState
 	});
-	setReadOnly( mt19937, 'STATE_SIZE', N+1 );
+	setReadOnly( mt19937, 'STATE_LENGTH', N+1 );
+	setReadOnly( mt19937, 'STATE_SIZE', mt19937.STATE_LENGTH/4 ); // 4 bytes per uint32
 
 	setReadOnly( normalized, 'NAME', mt19937.NAME );
 	defineProperty( normalized, 'SEED', {
@@ -431,6 +432,7 @@ function factory( options ) {
 		'get': getState,
 		'set': setState
 	});
+	setReadOnly( normalized, 'STATE_LENGTH', mt19937.STATE_LENGTH );
 	setReadOnly( normalized, 'STATE_SIZE', mt19937.STATE_SIZE );
 
 	return mt19937;

lib/node_modules/@stdlib/random/base/mt19937/test/test.factory.js

@@ -276,6 +276,12 @@ tape( 'attached to the returned function is the generator state', function test(
 	t.end();
 });
 
+tape( 'attached to the returned function is the generator state length', function test( t ) {
+	var mt19937 = factory();
+	t.equal( typeof mt19937.STATE_LENGTH, 'number', 'has `STATE_LENGTH` property' );
+	t.end();
+});
+
 tape( 'attached to the returned function is the generator state size', function test( t ) {
 	var mt19937 = factory();
 	t.equal( typeof mt19937.STATE_SIZE, 'number', 'has `STATE_SIZE` property' );
@@ -409,6 +415,12 @@ tape( 'attached to the `normalized` method is the generator state size', functio
 	t.end();
 });
 
+tape( 'attached to the `normalized` method is the generator state length', function test( t ) {
+	var mt19937 = factory();
+	t.equal( typeof mt19937.normalized.STATE_LENGTH, 'number', 'has `STATE_LENGTH` property' );
+	t.end();
+});
+
 tape( 'if the `STATE` property is set to a value other than a Uint32Array, an error is thrown (normalized)', function test( t ) {
 	var mt19937;
 	var values;

lib/node_modules/@stdlib/random/base/mt19937/test/test.js

@@ -71,6 +71,11 @@ tape( 'attached to the main export is the generator state', function test( t ) {
 	t.end();
 });
 
+tape( 'attached to the main export is the generator state length', function test( t ) {
+	t.equal( typeof mt19937.STATE_LENGTH, 'number', 'has `STATE_LENGTH` property' );
+	t.end();
+});
+
 tape( 'attached to the main export is the generator state size', function test( t ) {
 	t.equal( typeof mt19937.STATE_SIZE, 'number', 'has `STATE_SIZE` property' );
 	t.end();
@@ -124,6 +129,11 @@ tape( 'attached to the `normalized` method is the generator state', function tes
 	t.end();
 });
 
+tape( 'attached to the `normalized` method is the generator state length', function test( t ) {
+	t.equal( typeof mt19937.normalized.STATE_LENGTH, 'number', 'has `STATE_LENGTH` property' );
+	t.end();
+});
+
 tape( 'attached to the `normalized` method is the generator state size', function test( t ) {
 	t.equal( typeof mt19937.normalized.STATE_SIZE, 'number', 'has `STATE_SIZE` property' );
 	t.end();