time-to-botec

Benchmark sampling in different programming languages
Log | Files | Refs | README

repl.txt (2501B)

      1 
      2 {{alias}}( N, x, stride )
      3     Reverses a strided array in-place.
      4 
      5     The `N` and `stride` parameters determine which elements in `x` are accessed
      6     at runtime.
      7 
      8     Indexing is relative to the first index. To introduce an offset, use typed
      9     array views.
     10 
     11     If `N <= 0`, the function returns `x` unchanged.
     12 
     13     Parameters
     14     ----------
     15     N: integer
     16         Number of indexed elements.
     17 
     18     x: Array<number>|TypedArray
     19         Input array.
     20 
     21     stride: integer
     22         Index increment for `x`.
     23 
     24     Returns
     25     -------
     26     x: Array<number>|TypedArray
     27         Input array `x`.
     28 
     29     Examples
     30     --------
     31     // Standard Usage:
     32     > var x = [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ];
     33     > {{alias}}( x.length, x, 1 )
     34     [ -3.0, -1.0, 4.0, -5.0, 3.0, 1.0, -2.0 ]
     35 
     36     // Using `N` and `stride` parameters:
     37     > x = [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ];
     38     > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
     39     > {{alias}}( N, x, 2 )
     40     [ 4.0, 1.0, 3.0, -5.0, -2.0, -1.0, -3.0 ]
     41 
     42     // Using view offsets:
     43     > var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
     44     > var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 );
     45     > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 );
     46     > {{alias}}( N, x1, 2 )
     47     <Float64Array>[ -6.0, 3.0, -4.0, 5.0, -2.0 ]
     48     > x0
     49     <Float64Array>[ 1.0, -6.0, 3.0, -4.0, 5.0, -2.0 ]
     50 
     51 {{alias}}.ndarray( N, x, stride, offset )
     52     Reverses a strided array in-place using alternative indexing semantics.
     53 
     54     While typed array views mandate a view offset based on the underlying
     55     buffer, the `offset` parameter supports indexing semantics based on a
     56     starting index.
     57 
     58     Parameters
     59     ----------
     60     N: integer
     61         Number of indexed elements.
     62 
     63     x: Array<number>|TypedArray
     64         Input array.
     65 
     66     stride: integer
     67         Index increment for `x`.
     68 
     69     offset: integer
     70         Starting index of `x`.
     71 
     72     Returns
     73     -------
     74     x: Array<number>|TypedArray
     75         Input array `x`.
     76 
     77     Examples
     78     --------
     79     // Standard Usage:
     80     > var x = [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ];
     81     > {{alias}}.ndarray( x.length, x, 1, 0 )
     82     [ -3.0, -1.0, 4.0, -5.0, 3.0, 1.0, -2.0 ]
     83 
     84     // Using an index offset:
     85     > x = [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ];
     86     > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
     87     > {{alias}}.ndarray( N, x, 2, 1 )
     88     [ 1.0, -6.0, 3.0, -4.0, 5.0, -2.0 ]
     89 
     90     See Also
     91     --------
     92