time-to-botec

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

repl.txt (2850B)

      1 
      2 {{alias}}( N, alpha, x, stride )
      3     Multiplies a vector `x` by a constant `alpha`.
      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` or `stride <= 0`, the function returns `x` unchanged.
     12 
     13     Parameters
     14     ----------
     15     N: integer
     16         Number of indexed elements.
     17 
     18     alpha: number
     19         Constant.
     20 
     21     x: Array<number>|TypedArray
     22         Input array.
     23 
     24     stride: integer
     25         Index increment for `x`.
     26 
     27     Returns
     28     -------
     29     x: Array<number>|TypedArray
     30         Input array.
     31 
     32     Examples
     33     --------
     34     // Standard Usage:
     35     > var x = [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ];
     36     > var alpha = 5.0;
     37     > {{alias}}( x.length, alpha, x, 1 )
     38     [ -10.0, 5.0, 15.0, -25.0, 20.0, -5.0, -15.0 ]
     39 
     40     // Using `N` and `stride` parameters:
     41     > x = [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ];
     42     > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
     43     > alpha = 5.0;
     44     > var stride = 2;
     45     > {{alias}}( N, alpha, x, stride )
     46     [ -10.0, 1.0, 15.0, -5.0, 20.0, -1.0, -3.0 ]
     47 
     48     // Using view offsets:
     49     > var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
     50     > var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 );
     51     > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 );
     52     > alpha = 5.0;
     53     > stride = 2;
     54     > {{alias}}( N, alpha, x1, stride )
     55     <Float64Array>[ -10.0, 3.0, -20.0, 5.0, -30.0 ]
     56     > x0
     57     <Float64Array>[ 1.0, -10.0, 3.0, -20.0, 5.0, -30.0 ]
     58 
     59 {{alias}}.ndarray( N, alpha, x, stride, offset )
     60     Multiplies `x` by a constant `alpha` using alternative indexing semantics.
     61 
     62     While typed array views mandate a view offset based on the underlying
     63     buffer, the `offset` parameter supports indexing semantics based on a
     64     starting index.
     65 
     66     Parameters
     67     ----------
     68     N: integer
     69         Number of indexed elements.
     70 
     71     alpha: number
     72         Constant.
     73 
     74     x: Array<number>|TypedArray
     75         Input array.
     76 
     77     stride: integer
     78         Index increment for `x`.
     79 
     80     offset: integer
     81         Starting index of `x`.
     82 
     83     Returns
     84     -------
     85     x: Array<number>|TypedArray
     86         Input array.
     87 
     88     Examples
     89     --------
     90     // Standard Usage:
     91     > var x = [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ];
     92     > var alpha = 5.0;
     93     > {{alias}}.ndarray( x.length, alpha, x, 1, 0 )
     94     [ -10.0, 5.0, 15.0, -25.0, 20.0, -5.0, -15.0 ]
     95 
     96     // Using an index offset:
     97     > x = [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ];
     98     > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
     99     > alpha = 5.0;
    100     > var stride = 2;
    101     > {{alias}}.ndarray( N, alpha, x, stride, 1 )
    102     [ 1.0, -10.0, 3.0, -20.0, 5.0, -30.0 ]
    103 
    104     See Also
    105     --------
    106