Stdlib

https://github.com/stdlib-js/stdlib
Admin
Stdlib is a standard library for JavaScript with an emphasis on numerical and scientific...
Tokens:16,188,458
Snippets:118,597
Trust Score:-
License:Apache-2.0
Update:5 months ago
Show doc for...
Tokens:
Raw
### RPM Installation Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/datasets/spam-assassin/data/easy-ham-1/01072.81ed44b31e111f9c1e47e53f4dfbefe3.txt

This example demonstrates the process of installing an RPM package using the `rpm -ivh` command, showing the progress indicator.

```bash
rpm -ivh apg-1.2.13-fr1.i386.rpm
Preparing...                ###########################################
[100%]   1:apg
########################################### [100%]
```

--------------------------------

### Full CLI Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/cli/ctor/README.md

An example demonstrating the setup and execution of a command-line interface using @stdlib/cli, including loading configuration, defining options, and running a main function.

```javascript
var join = require( 'path' ).join;
var readFileSync = require( '@stdlib/fs/read-file' ).sync;
var CLI = require( '@stdlib/cli/ctor' );
var main = require( './examples/fixtures/main.js' );

// Load help text:
var fopts = {
    'encoding': 'utf8'
};
var help = readFileSync( join( __dirname, 'examples', 'fixtures', 'usage.txt' ), fopts );

// Set the command-line interface options:
var opts = {
    'pkg': require( './package.json' ),
    'options': require( './examples/fixtures/opts.json' ),
    'help': help,
    'title': true,
    'updates': true
};

// Create a new command-line interface:
var cli = new CLI( opts );

// Run main:
main( 'beep' );

// Close:
cli.close( 0 );
```

--------------------------------

### Example usage of configdir

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/os/configdir/README.md

Demonstrates how to use the configdir function to get a configuration directory path and log it to the console. This example appends 'appy/config' to the base directory.

```javascript
var configdir = require( '@stdlib/os/configdir' );

console.log( configdir( 'appy/config' ) );
```

--------------------------------

### Full example with custom options and directory creation

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/docs/www/benchmark-bundles/README.md

An example demonstrating the creation of benchmark bundles with custom directory, package patterns, ignored files, and ensuring the output directory exists before building.

```javascript
var mkdir = require( 'fs' ).mkdirSync;
var resolve = require( 'path' ).resolve;
var exists = require( '@stdlib/fs/exists' ).sync;
var build = require( '@stdlib/_tools/docs/www/benchmark-bundles' );

var dpath = resolve( __dirname, 'build' );

var opts = {
    'dir': './lib/node_modules',
    'packages_pattern': '**/base/special/sin/package.json',
    'ignore': [
        'benchmark/**',
        'bin/**',
        'build/**',
        'docs/**',
        'etc/**',
        'examples/**',
        'reports/**',
        'scripts/**',
        'test/**',
        '**/_tools/**'
    ]
};

if ( !exists( dpath ) ) {
    mkdir( dpath );
}
build( dpath, opts, done );

function done( error ) {
    if ( error ) {
        throw error;
    }
    console.log( 'Finished!' );
}
```

--------------------------------

### List Example Files

Source: https://github.com/stdlib-js/stdlib/blob/develop/tools/make/README.md

To list all example files in the project, use the `make list-examples` command.

```bash
$ make list-examples
```

--------------------------------

### Install and Setup Playwright

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/scripts/templates/workflow_test_bundles.yml.txt

Installs Playwright and its browser dependencies for headless browser testing.

```bash
      # Install playwright for headless browser testing:
      - name: 'Install playwright'
        run: |
          npm install playwright
          npx playwright install --with-deps chromium
```

--------------------------------

### Get Slice Start Index

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/slice/ctor/README.md

Access the 'start' property to retrieve the starting index of a Slice instance. Returns null if not explicitly set.

```javascript
var s = new Slice( 10 );
// returns <Slice>

var start = s.start;
// returns null

s = new Slice( 2, 10 );
// returns <Slice>

start = s.start;
// returns 2
```

--------------------------------

### Start a Tutorial

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/docs/commands/tutorial.txt

Starts a tutorial with the specified name. If no name is provided, a list of available tutorials is printed. Existing workspaces are cleared by default.

```javascript
var id = tutorial( 'repl' );
```

--------------------------------

### Example: Get GitHub User Rate Limit Status with Custom User Agent

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/github/user-rate-limit/README.md

An example demonstrating how to get the GitHub user rate limit status with a custom user agent and handle potential errors. Note that a valid GitHub token is required to run this example.

```javascript
var ratelimit = require( '@stdlib/_tools/github/user-rate-limit' );

var opts = {
    'token': 'tkjorjk34ek3nj4!',
    'useragent': 'beep-boop-bop'
};

ratelimit( opts, clbk );

function clbk( error, status ) {
    if ( error ) {
        if ( error instanceof Error ) {
            throw error;
        }
        console.error( error.message );
    } else {
        console.log( status );
    }
}
```

--------------------------------

### Get Uint32Array.prototype.byteOffset

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/array/uint32/README.md

Access the byteOffset property of a Uint32Array instance to get its offset from the start of its ArrayBuffer.

```javascript
var arr = new Uint32Array( 5 );
var byteOffset = arr.byteOffset;
// returns 0
```

--------------------------------

### Boot Menu Language Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/datasets/spam-assassin/data/easy-ham-2/00164.9e2e72c2afac966e790a7ab09ef24937.txt

This example demonstrates a simple one-liner in a pascal-ish language for writing boot menus, specifically for booting from a partition.

```pascal
boot /dev/hda1
```

--------------------------------

### CLI Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/benchmarks/html/README.md

Example of how to run the `benchmarks-html` CLI tool, providing the URL of the benchmarks bundle.

```bash
$ benchmarks-html /foo/bar/beep.js
```

--------------------------------

### CLI usage example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/utils/type-min/README.md

Example of using the typemin CLI to get the minimum value for 'int16'.

```bash
$ typemin int16
-32768
```

--------------------------------

### Example Bundle Usage

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/tests/bundle/README.md

An example demonstrating how to bundle files from a specific root directory with a custom pattern, logging the result.

```javascript
var join = require( 'path' ).join;
var bundle = require( '@stdlib/_tools/tests/bundle' );

var root = join( __dirname, 'fixtures' );

var opts = {
    'pattern': '*.js'
};

bundle( root, opts, onBundle );

function onBundle( error, bundle ) {
    if ( error ) {
        throw error;
    }
    console.log( bundle.toString() );
}
```

--------------------------------

### CLI usage example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/utils/type-max/README.md

Example of using the `typemax` CLI to get the maximum value for int16.

```bash
$ typemax int16
32767
```

--------------------------------

### Run Examples with Make

Source: https://github.com/stdlib-js/stdlib/blob/develop/docs/contributing/FAQ.md

Execute examples, optionally filtering them using EXAMPLES_FILTER.

```bash
$ make EXAMPLES_FILTER=".*/math/base/special/abs/.*" examples
```

--------------------------------

### CLI Usage Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/signature/README.md

Example of how to use the stdlib-alias-signature command-line interface to get the signature of an alias.

```bash
$ stdlib-alias-signature 'base.sin'
```

--------------------------------

### Start Tutorial

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/docs/commands/tutorial.txt

Starts an interactive tutorial. If no tutorial name is provided, a list of available tutorials is displayed. Existing workspaces are cleared unless a new workspace name is specified.

```APIDOC
## tutorial( [name, [options]] )

### Description
Starts a tutorial. When not provided a tutorial name, the function prints a list of available tutorials. If a specified workspace already exists, the workspace is silently cleared and a new tutorial presentation bound. In order to preserve an existing workspace, specify an alternative tutorial workspace name.

### Method
[Function Call]

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
- **name** (string) - Optional - Tutorial name.
- **options** (Object) - Optional - Tutorial options.
  - **options.borderTop** (string) - Optional - Top border character sequence. Default: '*'.
  - **options.borderBottom** (string) - Optional - Bottom border character sequence. Default: '*'.
  - **options.borderLeft** (string) - Optional - Left border character sequence. Default: '* '.
  - **options.borderRight** (string) - Optional - Right border character sequence. Default: ' *'.
  - **options.counter** (string|boolean) - Optional - Slide counter. If `true`, each tutorial slide displays a slide counter. If set to 'progress', each tutorial slide displays a progress counter. If `false`, no counter is displayed. Default: 'progress'.
  - **options.workspace** (string) - Optional - REPL workspace name. A tutorial presentation adds commands to the specified workspace, thus allowing tutorial navigation and interaction. Default: `'tutorial-<name>-<n>'`, where `name` is the tutorial name and `n` is an assigned tutorial presentation identifier.
  - **options.autoClear** (boolean) - Optional - Boolean indicating whether to automatically clear the screen before writing a rendered tutorial slide to the REPL. Default: true.

### Request Example
```javascript
tutorial( 'repl' );
```

### Response
#### Success Response (200)
- **out** (integer|void) - Tutorial presentation identifier.

#### Response Example
```javascript
// Returns an integer identifier for the tutorial presentation
```

### See Also
- presentationStart
- presentationStop
- workspace
- workspaces
```

--------------------------------

### Get an example for a known alias

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/code-blocks/README.md

Call the `example` function with a valid alias string (e.g., 'base.sin') to retrieve its associated code example. The function returns a string containing the example code.

```javascript
var out = example( 'base.sin' );
// returns <string>
```

--------------------------------

### Example: Bundle Fixture File

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/browserify/file-list/README.md

An example demonstrating how to bundle a specific fixture file and log its content. Ensure the path to the fixture is correctly specified.

```javascript
var join = require( 'path' ).join;
var bundle = require( '@stdlib/_tools/browserify/file-list' );

var fpath = join( __dirname, 'examples', 'fixtures', 'index.js' );
var files = [ fpath ];

bundle( files, onBundle );

function onBundle( error, output ) {
    if ( error ) {
        throw error;
    }
    console.log( output.toString() );
}
```

--------------------------------

### CLI Usage Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/help/README.md

Example of how to use the stdlib-alias-help command-line interface to get help text for a specific alias.

```bash
$ stdlib-alias-help 'base.sin'
```

--------------------------------

### Verify Environment with Examples

Source: https://github.com/stdlib-js/stdlib/blob/develop/docs/contributing/development.md

Run project examples to verify the environment configuration. This example filters for examples related to the 'sin' function in math/base/special.

```bash
$ make EXAMPLES_FILTER=".*/math/base/special/sin/.*" examples
```

--------------------------------

### Get Example by Alias

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/code-blocks/README.md

Retrieves a code example string for a given stdlib alias. Returns null if the alias is not recognized.

```APIDOC
## GET /api/example

### Description
Returns an example associated with a provided alias.

### Method
GET

### Endpoint
/api/example

### Parameters
#### Query Parameters
- **alias** (string) - Required - The alias for which to retrieve an example (e.g., 'base.sin').

### Request Example
```json
{
  "alias": "base.sin"
}
```

### Response
#### Success Response (200)
- **example** (string) - A string containing the code example for the alias, or null if the alias is not found.

#### Response Example
```json
{
  "example": "var sin = require('@stdlib/math/base/special/sin');\nvar y = sin( 3.141592653589793 );"
}
```

#### Error Response (404)
- **error** (string) - Indicates that the alias was not found.

#### Response Example
```json
{
  "error": "Alias not found."
}
```
```

--------------------------------

### JavaScript Example with Random Input

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/math/base/special/sincosf/README.md

This example demonstrates using sincosf with an array of random single-precision floats. Ensure necessary modules are installed.

```javascript
var uniform = require( '@stdlib/random/array/uniform' );
var TWO_PI = require( '@stdlib/constants/float32/two-pi' );
var sincosf = require( '@stdlib/math/base/special/sincosf' );

var opts = {
    'dtype': 'float32'
};
var x = uniform( 100, 0.0, TWO_PI, opts );

var y;
var i;
for ( i = 0; i < x.length; i++ ) {
    y = sincosf( x[ i ] );
    console.log( 'sincosf(%d) = [ %d, %d ]', x[ i ], y[ 0 ], y[ 1 ] );
}
```

--------------------------------

### Example Usage with Path Resolution

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/pkgs/entry-points/README.md

Example demonstrating how to resolve package entry points using an absolute path for one of the packages.

```javascript
var resolve = require( 'path' ).resolve;
var entryPoints = require( '@stdlib/_tools/pkgs/entry-points' );

var pkg = resolve( __dirname, '../' );
var pkgs = [ pkg, 'tape' ];

entryPoints( pkgs, onEntries );

function onEntries( error, results ) {
    if ( error ) {
        throw error;
    }
    console.dir( results );
}
```

--------------------------------

### C Example with Header Inclusion

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_complete.md.txt

A basic C code example that includes a header file. This serves as a starting point for C implementations.

```c
// C example
#include "foo.h"
```

--------------------------------

### Get inherited properties of an array

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/utils/inherited-properties/README.md

This example demonstrates how to get the inherited properties of an array. By default, the function traverses the entire prototype chain.

```javascript
var props = inheritedProperties( [ 1, 2, 3 ] );
// returns [...]
```

--------------------------------

### Async Examples with Options

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/fs/resolve-parent-paths/README.md

Demonstrates asynchronous path resolution with different options, including specifying a directory and handling non-existent paths.

```javascript
var opts = {
    'dir': __dirname
};

resolveParentPaths( [ 'package.json', 'README.md' ], opts, onPaths );
resolveParentPaths( [ './../non_existent_path' ], onPaths );

function onPaths( error, paths ) {
    if ( error ) {
        throw error;
    }
    console.log( paths );
}
```

--------------------------------

### Import get function from @stdlib/_tools/github/get

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/github/get/README.md

Use this snippet to import the `get` function for retrieving GitHub API resources. Ensure the package is installed.

```javascript
var get = require( '@stdlib/_tools/github/get' );
```

--------------------------------

### Example bundle usage with path join and pattern

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/benchmarks/bundle/README.md

An example demonstrating how to bundle benchmark files from a specific root directory with a custom pattern, using `path.join` for path construction.

```javascript
var join = require( 'path' ).join;
var bundle = require( '@stdlib/_tools/benchmarks/bundle' );

var root = join( __dirname, 'fixtures' );

var opts = {
    'pattern': '*.js'
};

bundle( root, opts, onBundle );

function onBundle( error, bundle ) {
    if ( error ) {
        throw error;
    }
    console.log( bundle.toString() );
}
```

--------------------------------

### Full Example with Options

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/benchmarks/browser-build/README.md

A comprehensive example demonstrating how to build browser benchmark assets with specific options for pattern, bundle, and HTML filenames. It also includes directory creation and error handling.

```javascript
var join = require( 'path' ).join;
var resolve = require( 'path' ).resolve;
var mkdirp = require( 'mkdirp' ).sync;
var build = require( '@stdlib/_tools/benchmarks/browser-build' );

var root = join( __dirname, 'fixtures' );
var out = resolve( __dirname, '../build' );

mkdirp( out );

var opts = {
    'pattern': 'index.js',
    'bundle': 'benchmark_bundle.js',
    'html': 'benchmarks.html'
};

build( root, out, opts, clbk );

function clbk( error, bool ) {
    if ( error ) {
        throw error;
    }
    if ( bool ) {
        console.log( 'Success!' );
    } else {
        console.log( 'No generated assets.' );
    }
}
```

--------------------------------

### Get next code point index from start

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/string/next-code-point-index/README.md

Find the index of the next Unicode code point in a string, starting the search from the beginning.

```javascript
var out = nextCodePointIndex( 'last man standing' );
// returns 1
```

--------------------------------

### Example: Star a repository with token and user agent

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/github/star-repo/README.md

A complete example demonstrating how to star a repository, requiring a GitHub access token and optionally a user agent. Ensure to replace '<your_token_goes_here>' with your actual token.

```javascript
var star = require( '@stdlib/_tools/github/star-repo' );

var opts = {
    'token': '<your_token_goes_here>',
    'useragent': 'beep-boop-bop'
};

star( 'stdlib-js/stdlib', opts, clbk );

function clbk( error, info ) {
    if ( info ) {
        console.error( info );
    }
    if ( error ) {
        if ( error instanceof Error ) {
            throw error;
        }
        console.error( error.message );
    } else {
        console.log( 'Success!' );
    }
}
```

--------------------------------

### Example usage of dapxsum.ndarray

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/ext/base/wasm/dapxsum/README.md

Demonstrates the usage of the dapxsum.ndarray function with randomly generated data. This example assumes the necessary @stdlib modules are installed and available.

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var dapxsum = require( '@stdlib/blas/ext/base/wasm/dapxsum' );

var opts = {
    'dtype': 'float64'
};
var x = discreteUniform( 10, 0, 100, opts );
console.log( x );

var sum = dapxsum.ndarray( x.length, 5.0, x, 1, 0 );
console.log( sum );
```

--------------------------------

### Get Float32 Size - JavaScript

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/constants/float32/num-bytes/docs/repl.txt

Access the `float32` constant to get the size in bytes of a single-precision floating-point number. This value is fixed and does not require any setup.

```javascript
const alias = require('@stdlib/constants-float32/size');

console.log(alias);
// returns 4
```

--------------------------------

### Comprehensive file tree build example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/docs/www/readme-fragment-file-tree/README.md

A comprehensive example demonstrating how to build an HTML rendered package README file tree. It includes setting a custom directory, ignore patterns, and handling the build process with a callback.

```javascript
var mkdir = require( 'fs' ).mkdirSync;
var resolve = require( 'path' ).resolve;
var exists = require( '@stdlib/fs/exists' ).sync;
var build = require( '@stdlib/_tools/docs/www/readme-fragment-file-tree' );

var dpath = resolve( __dirname, 'build' );

var opts = {
    'dir': './lib/node_modules',
    'ignore': [
        'benchmark/**',
        'bin/**',
        'build/**',
        'docs/**',
        'etc/**',
        'examples/**',
        'reports/**',
        'scripts/**',
        'test/**'
    ]
};

if ( !exists( dpath ) ) {
    mkdir( dpath );
}
build( dpath, opts, done );

function done( error ) {
    if ( error ) {
        throw error;
    }
    console.log( 'Finished!' );
}
```

--------------------------------

### ndarray.prototype.offset

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/ndarray/base/ctor/docs/repl.txt

Gets the index offset for the start of array element iteration.

```APIDOC
## ndarray.prototype.offset

### Description
Index offset which specifies the buffer index at which to start iterating
over array elements.

### Method
`{{alias}}.prototype.offset`

### Parameters
None

### Response
#### Success Response (200)
- **offset** (integer) - Index offset.

### Response Example
```json
{
  "example": "0"
}
```
```

--------------------------------

### Run All Package Examples

Source: https://github.com/stdlib-js/stdlib/blob/develop/tools/make/README.md

Executes all example files for all packages in the project. This command is used to verify that examples are functioning correctly.

```bash
$ make examples
```

--------------------------------

### tuple.byteOffset

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/dstructs/named-typed-tuple/README.md

Gets the offset (in bytes) of a tuple from the start of its underlying ArrayBuffer.

```APIDOC
## tuple.byteOffset

### Description
Gets the offset (in bytes) of a tuple from the start of its underlying [`ArrayBuffer`][@stdlib/array/buffer].

### Method
Property Access

### Endpoint
N/A

### Parameters
None

### Request Body
None

### Request Example
```javascript
var ArrayBuffer = require( '@stdlib/array/buffer' );
var factory = namedtypedtuple( [ 'x', 'y' ] );
var tuple = factory( [ 1.0, -1.0 ] );
var offset = tuple.byteOffset;
// returns 0

var buf = new ArrayBuffer( 64 );
tuple = factory( buf, 32 );
offset = tuple.byteOffset;
// returns 32
```

### Response
#### Success Response (200)
- **byteOffset** (number) - The byte offset of the tuple within its underlying buffer.

#### Response Example
```json
0
```
```

--------------------------------

### Launching the stdlib REPL

Source: https://context7.com/stdlib-js/stdlib/llms.txt

Install the stdlib package globally to access the interactive REPL environment. Use commands like 'help', 'example', and namespace exploration within the REPL.

```bash
# Install globally
npm install -g @stdlib/stdlib

# Launch REPL
stdlib repl
```

--------------------------------

### Print Help for Custom Bundling (Bash)

Source: https://github.com/stdlib-js/stdlib/blob/develop/README.md

Run this command to print help documentation for providing a list of stdlib package names to bundle. Ensure NODE_PATH is set correctly.

```bash
$ NODE_PATH=./lib/node_modules node ./bin/cli bundle-pkg-list -- -h
```

--------------------------------

### Example usage of dcopy

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/base/ndarray/dcopy/README.md

This example demonstrates how to use `dcopy` to copy elements from one randomly generated ndarray to another. Ensure you have the necessary modules installed.

```javascript
var discreteUniform = require( '@stdlib/random/discrete-uniform' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var dcopy = require( '@stdlib/blas/base/ndarray/dcopy' );

var opts = {
    'dtype': 'float64'
};

var x = discreteUniform( [ 10 ], 0, 100, opts );
console.log( ndarray2array( x ) );

var y = discreteUniform( [ 10 ], 0, 10, opts );
console.log( ndarray2array( y ) );

var out = dcopy( [ x, y ] );
console.log( ndarray2array( out ) );
```

--------------------------------

### Example: Copy elements from x into y starting from the end of y

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/base/dcopy/README.md

Generates two Float64Arrays with random values and then copies elements from `x` into `y` starting from the end of `y` (negative stride).

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var dcopy = require( '@stdlib/blas/base/dcopy' );

var opts = {
    'dtype': 'float64'
};
var x = discreteUniform( 10, 0, 500, opts );
console.log( x );

var y = discreteUniform( x.length, 0, 255, opts );
console.log( y );

// Copy elements from `x` into `y` starting from the end of `y`:
dcopy( x.length, x, 1, y, -1 );
console.log( y );
```

--------------------------------

### Example Usage of pkgDeps with Path Joining

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/modules/pkg-deps/README.md

Demonstrates a practical example of using `pkgDeps` by joining a directory name with a file name to specify the target file. Includes a callback for handling results.

```javascript
var join = require( 'path' ).join;
var pkgDeps = require( '@stdlib/_tools/modules/pkg-deps' );

var file = join( __dirname, 'lib', 'index.js' );

pkgDeps( file, clbk );

function clbk( error, results ) {
    if ( error ) {
        throw error;
    }
    console.dir( results );
}
```

--------------------------------

### CLI Usage Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/pkgs/names/README.md

Demonstrates the basic command-line interface for listing package names without any specific options.

```bash
$ stdlib-pkg-names
<package_name>
<package_name>
...
```

--------------------------------

### Example with random data

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/ext/base/ndarray/gindex-of/README.md

This example shows how to use gindexOf with a randomly generated ndarray. It logs the ndarray, the search element, the starting index, and the resulting index.

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var ndarray = require( '@stdlib/ndarray/base/ctor' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' );
var gindexOf = require( '@stdlib/blas/ext/base/ndarray/gindex-of' );

var xbuf = discreteUniform( 10, -100, 100, {
    'dtype': 'generic'
});
var x = new ndarray( 'generic', xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
console.log( ndarray2array( x ) );

var searchElement = scalar2ndarray( 80.0, {
    'dtype': 'generic'
});
console.log( 'Search Element:', ndarraylike2scalar( searchElement ) );

var fromIndex = scalar2ndarray( 0, {
    'dtype': 'generic'
});
console.log( 'From Index:', ndarraylike2scalar( fromIndex ) );

var idx = gindexOf( [ x, searchElement, fromIndex ] );
console.log( idx );
```

--------------------------------

### Get Example by Alias in JavaScript

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/code-blocks/docs/repl.txt

Use this function to retrieve an example associated with a specific alias. Ensure the alias is correctly formatted, for instance, '{{alias:@stdlib/math/base/special/sin}}'.

```javascript
var txt = {{alias}}( '{{alias:@stdlib/math/base/special/sin}}' )
```

--------------------------------

### CLI Example Execution

Source: https://github.com/stdlib-js/stdlib/blob/develop/tools/snippets/cli.md

Demonstrates a basic execution of the CLI tool.

```bash
$ TODO
TODO
```

--------------------------------

### Booting Linux with Extra Parameters

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/datasets/spam-assassin/data/easy-ham-2/00277.943b5336f2a39a88253257d0b6db1d32.txt

This example shows how to boot Linux directly without a selection prompt by passing extra parameters on the boot command line.

```shell
boot disk linux
```

--------------------------------

### Start HTTP Server

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/net/http-server/README.md

Create an HTTP server and then start listening for requests using a provided callback function.

```javascript
function done( error, server ) {
    if ( error ) {
        throw error;
    }
    console.log( 'Success!' );
    server.close();
}

var httpServer = httpServerFactory();

httpServer( done );
```

--------------------------------

### Example: Nullary Callback for 8D Array

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/ndarray/base/nullary/scripts/templates/source.txt

Example demonstrating the setup and application of a nullary callback for an 8-dimensional ndarray. Includes necessary includes and array configuration.

```c
#include "stdlib/ndarray/base/nullary/{{SIGNATURE}}.h"
#include "stdlib/ndarray/dtypes.h"
#include "stdlib/ndarray/index_modes.h"
#include "stdlib/ndarray/orders.h"
#include "stdlib/ndarray/ctor.h"{{EXAMPLE_INCLUDES}}
#include <stdint.h>
#include <stdlib.h>
#include <stdio.h>

// Define the ndarray data type:
enum STDLIB_NDARRAY_DTYPE xdtype = STDLIB_NDARRAY_{{OUTPUT_NDARRAY_DTYPE_UPPER}};

// Create an underlying byte array:
uint8_t xbuf[] = { {{OUTPUT_NDARRAY_BYTES_8D}} };

// Define the number of dimensions:
int64_t ndims = 8;

// Define the array shape:
int64_t shape[] = { {{NDARRAY_SHAPE_8D}} };

// Define the strides:
int64_t sx[] = { {{OUTPUT_NDARRAY_STRIDES_8D}} };

// Define the index offset:
int64_t ox = 0;

// Define the array order:
enum STDLIB_NDARRAY_ORDER order = STDLIB_NDARRAY_ROW_MAJOR;

// Specify the index mode:
enum STDLIB_NDARRAY_INDEX_MODE imode = STDLIB_NDARRAY_INDEX_ERROR;

// Specify the subscript index modes:
int8_t submodes[] = { imode };
int64_t nsubmodes = 1;

// Create an output ndarray:
struct ndarray *x = stdlib_ndarray_allocate( xdtype, xbuf, ndims, shape, sx, ox, order, imode, nsubmodes, submodes );
if ( x == NULL ) {
    fprintf( stderr, "Error allocating memory.\n" );
    exit( EXIT_FAILURE );
}

// Create an array containing a pointer to the ndarray:
struct ndarray *arrays[] = { x };

// Define a callback:
static {{CALLBACK_RETURN_DTYPE}} fcn( void ) {
    {{CALLBACK_BODY}}
}

// Apply the callback:
int8_t status = stdlib_ndarray_{{SIGNATURE}}_8d( arrays, (void *)fcn );
if ( status != 0 ) {
    fprintf( stderr, "Error during computation.\n" );
    exit( EXIT_FAILURE );
}

// ...

// Free allocated memory:
stdlib_ndarray_free( x );
```

--------------------------------

### Example: Nullary Callback for 6D Ndarray

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/ndarray/base/nullary/scripts/templates/source.txt

An example demonstrating the setup and application of a nullary callback for a 6-dimensional ndarray. Includes necessary includes and ndarray configuration.

```c
#include "stdlib/ndarray/base/nullary/{{SIGNATURE}}.h"
#include "stdlib/ndarray/dtypes.h"
#include "stdlib/ndarray/index_modes.h"
#include "stdlib/ndarray/orders.h"
#include "stdlib/ndarray/ctor.h"{{EXAMPLE_INCLUDES}}
#include <stdint.h>
#include <stdlib.h>
#include <stdio.h>

// Define the ndarray data type:
enum STDLIB_NDARRAY_DTYPE xdtype = STDLIB_NDARRAY_{{OUTPUT_NDARRAY_DTYPE_UPPER}};

// Create an underlying byte array:
uint8_t xbuf[] = { {{OUTPUT_NDARRAY_BYTES_6D}} };

// Define the number of dimensions:
int64_t ndims = 6;

// Define the array shape:
int64_t shape[] = { {{NDARRAY_SHAPE_6D}} };

// Define the strides:
int64_t sx[] = { {{OUTPUT_NDARRAY_STRIDES_6D}} };

// Define the index offset:
int64_t ox = 0;

// Define the array order:
enum STDLIB_NDARRAY_ORDER order = STDLIB_NDARRAY_ROW_MAJOR;

// Specify the index mode:
enum STDLIB_NDARRAY_INDEX_MODE imode = STDLIB_NDARRAY_INDEX_ERROR;

// Specify the subscript index modes:
int8_t submodes[] = { imode };
int64_t nsubmodes = 1;

// Create an output ndarray:
struct ndarray *x = stdlib_ndarray_allocate( xdtype, xbuf, ndims, shape, sx, ox, order, imode, nsubmodes, submodes );
if ( x == NULL ) {
    fprintf( stderr, "Error allocating memory.\n" );
    exit( EXIT_FAILURE );
}

// Create an array containing a pointer to the ndarray:
struct ndarray *arrays[] = { x };

// Define a callback:
static {{CALLBACK_RETURN_DTYPE}} fcn( void ) {
    {{CALLBACK_BODY}}
}

// Apply the callback:
int8_t status = stdlib_ndarray_{{SIGNATURE}}_6d( arrays, (void *)fcn );
if ( status != 0 ) {
    fprintf( stderr, "Error during computation.\n" );
    exit( EXIT_FAILURE );
}

// ...

// Free allocated memory:
stdlib_ndarray_free( x );
```

--------------------------------

### Example Fetch User Details with User Agent and Callback

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/github/user-details/README.md

An example demonstrating how to fetch user details for multiple users, including a custom user agent and a callback function to handle results and potential errors.

```javascript
var userinfo = require( '@stdlib/_tools/github/user-details' );

var opts = {
    'usernames': [
        'kgryte',
        'planeshifter',
        'rgizz'
    ],
    'useragent': 'beep-boop-bop'
};

userinfo( opts, clbk );

function clbk( error, results, info ) {
    if ( info ) {
        console.error( info );
    }
    if ( error ) {
        throw new Error( error.message );
    }
    console.dir( results );
}
```

--------------------------------

### Configure DCC with SpamAssassin

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/datasets/spam-assassin/data/easy-ham-1/00101.216942b87258b063ec2d7b7981ee2454.txt

After installing the DCC client, run the 'cdcc info' command to verify the installation and basic configuration. This command checks the DCC setup.

```bash
cdcc 'info'
```

--------------------------------

### Bundle Package List using @stdlib/_tools/bundle/pkg-list

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/bundle/pkg-list/README.md

This example shows how to use the pkgNames and bundle functions to create a package list bundle. It includes options for filtering packages by pattern and ignoring specific directories. The bundle is then printed to the console.

```javascript
var pkgNames = require( '@stdlib/_tools/pkgs/names' );
var bundle = require( '@stdlib/_tools/bundle/pkg-list' );

var fopts = {
    'pattern': '**/assert/**/package.json',
    'ignore': [
        '**/_**/**' // ignore "private" packages
    ]
};
var bopts = {
    'namespace': 'tree',
    'exportName': '@stdlib'
};

pkgNames( fopts, onNames );

function onNames( error, names ) {
    if ( error ) {
        throw error;
    }
    bundle( names, bopts, onBundle );
}

function onBundle( error, bundle ) {
    if ( error ) {
        throw error;
    }
    console.log( bundle.toString() );
}
```

--------------------------------

### CLI Usage Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/browserify/file-list/README.md

Command-line interface example for bundling files. This shows how to invoke the tool with a specific input file.

```bash
$ browserify-file-list ./examples/fixtures/index.js
```

--------------------------------

### Example usage of meanpn

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/stats/base/ndarray/meanpn/README.md

This example demonstrates how to use the meanpn function to compute the arithmetic mean of a randomly generated one-dimensional ndarray. Ensure necessary packages are installed.

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var ndarray = require( '@stdlib/ndarray/base/ctor' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var meanpn = require( '@stdlib/stats/base/ndarray/meanpn' );

var xbuf = discreteUniform( 10, -50, 50, {
    'dtype': 'generic'
});
var x = new ndarray( 'generic', xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
console.log( ndarray2array( x ) );

var v = meanpn( [ x ] );
console.log( v );
```

--------------------------------

### CLI example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/tests/html/README.md

Example of using the CLI to generate an HTML test file for a given bundle URL.

```bash
$ test-html /foo/bar/beep.js
```

--------------------------------

### JavaScript Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/math/base/special/floorsd/README.md

This example demonstrates how to use floorsd with random numbers and log the results. Ensure you have the necessary @stdlib packages installed for random number generation and logging.

```javascript
var uniform = require( '@stdlib/random/array/uniform' );
var logEachMap = require( '@stdlib/console/log-each-map' );
var floorsd = require( '@stdlib/math/base/special/floorsd' );

var opts = {
    'dtype': 'float32'
};
var x = uniform( 100, -5000.0, 5000.0, opts );

logEachMap( 'x: %0.4f. y: %d. z: %d. Rounded: %0.4f.', x, 5, 10, floorsd );
```

--------------------------------

### Example usage of prepare function

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/release/package-json/README.md

An example demonstrating how to use the `prepare` function to generate a `package.json` for a specific package, including development dependencies, and logging the output.

```javascript
var prepare = require( '@stdlib/_tools/release/package-json' );

var out = prepare( '@stdlib/plot/ctor', {
    'devDependencies': [
        'tape'
    ]
});
console.log( out );
```

--------------------------------

### Slice iterator from a specific start index

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/iter/slice/README.md

Create an iterator from an array and slice it starting from a specified index (inclusive). This example slices from the third element (index 2).

```javascript
var array2iterator = require( '@stdlib/array/to-iterator' );

var it = iterSlice( array2iterator( [ 1, 2, 3, 4 ] ), 2 );
// returns <Object>

var v = it.next().value;
// returns 3

v = it.next().value;
// returns 4

var bool = it.next().done;
// returns true
```

--------------------------------

### Get next larger data type

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/array/next-dtype/README.md

Call nextDataType with a data type string to get the next larger data type. For example, 'float32' returns 'float64'.

```javascript
var out = nextDataType( 'float32' );
// returns 'float64'
```

--------------------------------

### Run Full Install Sequence

Source: https://github.com/stdlib-js/stdlib/blob/develop/tools/make/lib/install/README.md

Executes the project's full installation sequence. Use with caution, as most development does not require a full installation.

```bash
$ make install-all
```

--------------------------------

### Get next grapheme cluster break from start

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/string/next-grapheme-cluster-break/README.md

Find the index of the first extended grapheme cluster break in a string. The search starts from the beginning of the string by default.

```javascript
var out = nextGraphemeClusterBreak( 'last man standing' );
// returns 1
```

--------------------------------

### Full Example: Create and Search Index

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/search/pkg-index/README.md

Demonstrates creating a search index from a specific directory and then loading and searching it using lunr.js. Handles cases where the index cannot be created.

```javascript
var join = require( 'path' ).join;
var lunr = require( 'lunr' );
var rootDir = require( '@stdlib/_tools/utils/root-dir' );
var pkgIndex = require( '@stdlib/_tools/search/pkg-index' );

// Define a directory containing READMEs from which to create a search index:
var dir = join( rootDir(), 'lib', 'node_modules', '@stdlib', 'math', 'base', 'special' );

// Create a search index:
var opts = {
    'dir': dir
};
pkgIndex( opts, onIndex );

function onIndex( error, idx ) {
    var store;
    var res;
    if ( error ) {
        throw error;
    }
    if ( idx === null ) {
        console.error( 'Unable to create search index. Try modifying package search criteria and trying again.' );
        return;
    }
    // Load the serialized index into Lunr:
    store = lunr.Index.load( idx );

    // Perform a search:
    res = store.search( 'sine' );
    console.log( JSON.stringify( res, null, '  ' ) );
}
```

--------------------------------

### Run Examples with Filter

Source: https://github.com/stdlib-js/stdlib/blob/develop/docs/contributing/development.md

Execute examples and filter them based on a pattern matching their paths.

```bash
$ make EXAMPLES_FILTER=".*/<pattern>/.*" examples
```

--------------------------------

### Usage Example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-html-section-structure/test/fixtures/valid_multiple.md.txt

Shows a basic usage example of the 'foo' module after requiring it.

```javascript
var foo = require( 'foo' );

// Usage example
foo();
```

--------------------------------

### Example usage of gcusumkbn2

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/ext/base/ndarray/gcusumkbn2/README.md

Demonstrates how to use `gcusumkbn2` with randomly generated data. This example includes setup for input and output ndarrays, an initial sum, and logging the results.

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var ndarray = require( '@stdlib/ndarray/base/ctor' );
var zerosLike = require( '@stdlib/ndarray/zeros-like' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var gcusumkbn2 = require( '@stdlib/blas/ext/base/ndarray/gcusumkbn2' );

var xbuf = discreteUniform( 10, -50, 50, {
    'dtype': 'generic'
});
var x = new ndarray( 'generic', xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
console.log( ndarray2array( x ) );

var y = zerosLike( x );
console.log( ndarray2array( y ) );

var initial = scalar2ndarray( 100.0, {
    'dtype': 'generic'
});

var v = gcusumkbn2( [ x, y, initial ] );
console.log( ndarray2array( v ) );
```

--------------------------------

### Compute Variance with ndarray and Offset

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/stats/base/snanvariancech/README.md

Use `snanvariancech.ndarray` to compute variance with explicit control over the starting `offset` and `stride`. This example calculates variance for every other element starting from the second.

```javascript
var Float32Array = require( '@stdlib/array/float32' );

var x = new Float32Array( [ 1.0, -2.0, NaN, 2.0 ] );

var v = snanvariancech.ndarray( x.length, 1, x, 1, 0 );
// returns ~4.33333
```

--------------------------------

### CLI example for release-package-json

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/release/package-json/README.md

Example of using the `release-package-json` command-line tool to prepare the `package.json` for a specific package.

```bash
$ release-package-json @stdlib/assert/is-boolean-array
```

--------------------------------

### Example usage of zoneTo

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/ext/base/zone-to/README.md

Demonstrates filling a Complex128Array with linearly spaced elements starting from 1, incrementing by 1. The example includes generating random data for the initial array.

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var Complex128Array = require( '@stdlib/array/complex128' );
var zoneTo = require( '@stdlib/blas/ext/base/zone-to' );

var xbuf = discreteUniform( 20, -100, 100, {
    'dtype': 'float64'
});
var x = new Complex128Array( xbuf.buffer );
console.log( x );

zoneTo( x.length, x, 1 );
console.log( x );
```

--------------------------------

### CLI usage example

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/_tools/benchmarks/bundle/README.md

Example of how to use the `benchmarks-bundle` CLI tool to bundle files with a specified pattern and root directory.

```bash
$ benchmarks-bundle --pattern 'index.js' ./examples/fixtures
```

--------------------------------

### Boot HTTP/2 Server

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/net/http2-secure-server/docs/repl.txt

Creates an HTTP/2 server and invokes a callback upon completion.

```APIDOC
## boot( done )

### Description
Creates an HTTP/2 server.

### Parameters
#### done
- **done** (Function) - Callback to invoke after creating a server.

### Example
```javascript
function done( error, server ) {
    if ( error ) {
        throw error;
    }
    console.log( 'Success!' );
    server.close();
};
var opts = { 'cert': '...', 'key': '...' };
var boot = {{alias}}( opts );
boot( done );
```

### See Also


```

--------------------------------

### Example usage of czeroTo

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/blas/ext/base/czero-to/README.md

Demonstrates filling a `Complex64Array` with values starting from zero and incrementing by one, after initializing it with random data. This example shows a practical application of the `czeroTo` function.

```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var Complex64Array = require( '@stdlib/array/complex64' );
var czeroTo = require( '@stdlib/blas/ext/base/czero-to' );

var xbuf = discreteUniform( 20, -100, 100, {
    'dtype': 'float32'
});
var x = new Complex64Array( xbuf.buffer );
console.log( x );

czeroTo( x.length, x, 1 );
console.log( x );
```

--------------------------------

### Full Example: Serving Local HTML and JavaScript Files

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/net/disposable-http-server/README.md

A comprehensive example demonstrating how to serve local HTML and JavaScript files using a disposable HTTP server. It configures the port, hostname, and sets `open` to `false`. A callback is used to close the server after a 5-second delay.

```javascript
var join = require( 'path' ).join;
var readFileSync = require( '@stdlib/fs/read-file' ).sync;
var httpServer = require( '@stdlib/net/disposable-http-server' );

var html = join( __dirname, 'examples', 'fixtures', 'index.html' );
var js = join( __dirname, 'examples', 'fixtures', 'script.js' );

var opts = {
    'html': readFileSync( html ),
    'javascript': readFileSync( js ),
    'port': 7331,
    'hostname': 'localhost',
    'open': false
};

httpServer( opts, clbk );

function clbk( error, server ) {
    if ( error ) {
        throw error;
    }
    // Give the user a few seconds to open her web browser before closing the server...
    setTimeout( onTimeout, 5000 );

    function onTimeout() {
        server.close();
    }
}
```

--------------------------------

### Get days in a specific year

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/time/days-in-year/README.md

Provide a Date object or a year number to get the number of days for that specific year. For example, 2000 had 366 days, while 2017 had 365.

```javascript
var num = daysInYear( new Date() );
// returns <number>

num = daysInYear( 2000 );
// returns 366

num = daysInYear( 2017 );
// returns 365
```

--------------------------------

### REPL Server CLI Usage

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/repl/server/README.md

Demonstrates how to start the REPL server from the command line. This command initiates the interactive REPL environment.

```bash
$ stdlib-repl-server
Starting REPL...
```

--------------------------------

### Get temporary directory path

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/os/tmpdir/README.md

Call the tmpdir function to get the path to the system's temporary directory. The output is an example and may vary based on the operating system.

```javascript
var dir = tmpdir();
// e.g., returns '/path/to/temporary/files/directory'
```

--------------------------------

### Create and Run Secure HTTP/2 Server

Source: https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/@stdlib/net/http2-secure-server/README.md

This example demonstrates how to create a secure HTTP/2 server using stdlib. It includes setting up server options, handling incoming requests, and initiating a client connection to test the server. Ensure you have the necessary certificate and key files.

```javascript
var proc = require( 'process' );
var http2 = require( 'http2' );
var resolve = require( 'path' ).resolve;
var readFileSync = require( '@stdlib/fs/read-file' ).sync;
var http2ServerFactory = require( '@stdlib/net/http2-secure-server' );

function done( error ) {
    var client;
    var req;
    if ( error ) {
        throw error;
    }
    client = http2.connect( 'https://localhost:7331', {
        'ca': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) )
    });
    req = client.request({
        ':path': '/beep/boop'
    });
    req.on( 'response', onResponse );
    req.end();

    function onResponse() {
        console.log( 'Success!' );
        client.close();
        proc.exit( 0 );
    }
}

function onRequest( request, response ) {
    console.log( request.url );
    response.end( 'OK' );
}

// Specify server options...
var opts = {
    'port': 7331,
    'maxport': 9999,
    'hostname': 'localhost',
    'allowHTTP1': true,
    'cert': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) ),
    'key': readFileSync( resolve( __dirname, 'examples', 'localhost-privkey.pem' ) )
};

// Create a function for creating an HTTP/2 server...
var http2Server = http2ServerFactory( opts, onRequest );

// Create a server:
http2Server( done );

```
Tokens:
Raw