/* * @license Apache-2.0 * * Copyright (c) 2023 The Stdlib Authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // TypeScript Version: 4.1 /// import { Slice } from '@stdlib/types/slice'; /** * Returns the number of elements in a normalized slice. * * @param slice - input slice * @returns number of elements * * @example * var Slice = require( '@stdlib/slice/ctor' ); * var normalizeSlice = require( '@stdlib/slice/base/normalize-slice' ); * * var s = new Slice( 2, null, 1 ); * // returns * * var v = sliceLength( normalizeSlice( s, 10, false ) ); * // returns 8 * * v = sliceLength( normalizeSlice( s, 11, false ) ); * // returns 9 * * v = sliceLength( normalizeSlice( s, 5, false ) ); * // returns 3 * * @example * var Slice = require( '@stdlib/slice/ctor' ); * var normalizeSlice = require( '@stdlib/slice/base/normalize-slice' ); * * var s = new Slice( 2, null, 2 ); * // returns * * var v = sliceLength( normalizeSlice( s, 10, false ) ); * // returns 4 * * v = sliceLength( normalizeSlice( s, 11, false ) ); * // returns 5 * * v = sliceLength( normalizeSlice( s, 5, false ) ); * // returns 2 * * @example * var Slice = require( '@stdlib/slice/ctor' ); * var normalizeSlice = require( '@stdlib/slice/base/normalize-slice' ); * * var s = new Slice( -1, null, -2 ); * * var v = sliceLength( normalizeSlice( s, 10, false ) ); * // returns 5 * * v = sliceLength( normalizeSlice( s, 11, false ) ); * // returns 6 * * v = sliceLength( normalizeSlice( s, 5, false ) ); * // returns 3 * * @example * var Slice = require( '@stdlib/slice/ctor' ); * var normalizeSlice = require( '@stdlib/slice/base/normalize-slice' ); * * var s = new Slice( 3, 5, -1 ); * * var v = sliceLength( normalizeSlice( s, 10, false ) ); * // returns 0 * * v = sliceLength( normalizeSlice( s, 11, false ) ); * // returns 0 * * v = sliceLength( normalizeSlice( s, 5, false ) ); * // returns 0 * * @example * var Slice = require( '@stdlib/slice/ctor' ); * var normalizeSlice = require( '@stdlib/slice/base/normalize-slice' ); * * var s = new Slice( 5, 3, 1 ); * * var v = sliceLength( normalizeSlice( s, 10, false ) ); * // returns 0 * * v = sliceLength( normalizeSlice( s, 11, false ) ); * // returns 0 * * v = sliceLength( normalizeSlice( s, 5, false ) ); * // returns 0 */ declare function sliceLength( slice: Slice ): number; // EXPORTS // export = sliceLength;