Auto-generated commit

Author: stdlib-bot

.github/.keepalive

@@ -77,7 +77,7 @@ Returns a list of array data types.
 
 ```javascript
 var out = dtypes();
-// e.g., returns [ 'float32', 'float64', 'generic', 'int16', 'int32', 'int8', 'uint16', 'uint32', 'uint8', 'uint8c', 'complex64', 'complex128' ]
+// e.g., returns [ 'float32', 'float64', ... ]
 ```
 
 When not provided a data type "kind", the function returns an array containing the following data types:
@@ -114,6 +114,13 @@ The function supports the following data type kinds:
 -   `numeric`: numeric data types.
 -   `all`: all data types.
 
+Additionally, the function supports extending the "kinds" listed above by appending an `_and_generic` suffix to the kind name (e.g., `real_and_generic`).
+
+```javascript
+var out = dtypes( 'floating_point_and_generic' );
+// returns [...]
+```
+
 </section>
 
 <!-- /.usage -->

README.md

@@ -71,3 +71,28 @@ bench( pkg+'::kind', function benchmark( b ) {
 	b.pass( 'benchmark finished' );
 	b.end();
 });
+
+bench( pkg+'::kind,generic', function benchmark( b ) {
+	var values;
+	var out;
+	var i;
+
+	values = [
+		'floating_point_and_generic',
+		'integer_and_generic'
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		out = dtypes( values[ i%values.length ] );
+		if ( out.length === 0 ) {
+			b.fail( 'should return a non-empty array' );
+		}
+	}
+	b.toc();
+	if ( !isStringArray( out ) ) {
+		b.fail( 'should return an array of strings' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});

benchmark/benchmark.js

@@ -30,6 +30,9 @@
     - numeric: numeric data types.
     - all: all data types.
 
+    Additionally, the function supports extending the "kinds" listed above by
+    appending a '_and_generic' suffix to the kind name (e.g., real_and_generic).
+
     Parameters
     ----------
     kind: string (optional)
@@ -43,9 +46,11 @@
     Examples
     --------
     > var out = {{alias}}()
-    <Array>
+    [...]
     > out = {{alias}}( 'floating_point' )
-    <Array>
+    [...]
+    > out = {{alias}}( 'floating_point_and_generic' )
+    [...]
 
     See Also
     --------

dist/index.js

@@ -30,7 +30,7 @@ import { DataType, DataTypeKind } from '@stdlib/types/array';
 *
 * @example
 * var list = dtypes();
-* // e.g., returns [ 'float32', 'float64', 'generic', 'int16', 'int32', 'int8', 'uint16', 'uint32', 'uint8', 'uint8c', 'complex64', 'complex128' ]
+* // e.g., returns [ 'float32', 'float64', ... ]
 *
 * @example
 * var list = dtypes( 'floating_point' );

dist/index.js.map

@@ -25,6 +25,7 @@ import dtypes = require( './index' );
 {
 	dtypes(); // $ExpectType DataType[]
 	dtypes( 'floating_point' ); // $ExpectType DataType[]
+	dtypes( 'floating_point_and_generic' ); // $ExpectType DataType[]
 }
 
 // The compiler throws an error if the function is provided an unsupported number of arguments...

docs/repl.txt

@@ -20,9 +20,15 @@
 
 // MODULES //
 
+var replace = require( '@stdlib/string-base-replace' );
 var DTYPES = require( './dtypes.json' );
 
 
+// VARIABLES //
+
+var RE_SUFFIX = /_and_generic$/;
+
+
 // MAIN //
 
 /**
@@ -33,19 +39,33 @@ var DTYPES = require( './dtypes.json' );
 *
 * @example
 * var list = dtypes();
-* // e.g., returns [ 'float32', 'float64', 'generic', 'int16', 'int32', 'int8', 'uint16', 'uint32', 'uint8', 'uint8c', 'complex64', 'complex128' ]
+* // e.g., returns [ 'float32', 'float64', ... ]
 *
 * @example
 * var list = dtypes( 'floating_point' );
 * // returns [...]
 */
 function dtypes() {
+	var kind;
 	var out;
+	var FLG;
 	if ( arguments.length === 0 ) {
 		return DTYPES.all.slice();
 	}
-	out = DTYPES[ arguments[ 0 ] ];
-	return ( out ) ? out.slice() : [];
+	FLG = false;
+	kind = arguments[ 0 ];
+	if ( RE_SUFFIX.test( kind ) ) {
+		kind = replace( kind, RE_SUFFIX, '' );
+		if ( kind !== 'all' ) {
+			FLG = true;
+		}
+	}
+	out = DTYPES[ kind ];
+	out = ( out ) ? out.slice() : [];
+	if ( FLG && out.length > 0 ) {
+		out.push( 'generic' );
+	}
+	return out;
 }
 
 

docs/types/index.d.ts

@@ -37,6 +37,7 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
+    "@stdlib/string-base-replace": "^0.1.1",
     "@stdlib/types": "^0.2.0"
   },
   "devDependencies": {