home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / scal.z / scal
Encoding:
Text File  |  2002-10-03  |  2.8 KB  |  80 lines
  1. SCAL(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSCCAALL, DDSSCCAALL, CCSSSSCCAALL, ZZDDSSCCAALL, CCSSCCAALL, ZZSSCCAALL - Scales a real or complex
  6.      vector
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSCCAALL ((_n,, _a_l_p_h_a,, _x,, _i_n_c_x))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDSSCCAALL ((_n,, _a_l_p_h_a,, _x,, _i_n_c_x))
  16.  
  17.      Complex
  18.  
  19.         CCAALLLL CCSSSSCCAALL ((_n,, _a_l_p_h_a,, _x,, _i_n_c_x))
  20.  
  21.         CCAALLLL CCSSCCAALL ((_n,, _a_l_p_h_a,, _x,, _i_n_c_x))
  22.  
  23.      Double complex
  24.  
  25.         CCAALLLL ZZDDSSCCAALL ((_n,, _a_l_p_h_a,, _x,, _i_n_c_x))
  26.  
  27.         CCAALLLL ZZSSCCAALL ((_n,, _a_l_p_h_a,, _x,, _i_n_c_x))
  28.  
  29. IIMMPPLLEEMMEENNTTAATTIIOONN
  30.      IRIX systems
  31.  
  32. DDEESSCCRRIIPPTTIIOONN
  33.      SSSSCCAALL/DDSSCCAALL scales a real vector with a real scalar.
  34.  
  35.      CCSSSSCCAALL/ZZDDSSCCAALL scales a complex vector with a real scalar.
  36.  
  37.      CCSSCCAALL/ZZSSCCAALL scales a complex vector with a complex scalar.
  38.  
  39.      These routines perform the following vector operation:
  40.  
  41.           _x <- _a_l_p_h_a _x
  42.  
  43.      where _a_l_p_h_a is a real or complex scalar, and _x is a real or complex
  44.      vector.
  45.  
  46.      These routines have the following arguments:
  47.  
  48.      _n         Integer.  (input)
  49.                Number of elements in the vector.  If _n <= 0, these routines
  50.                return without any computation.
  51.  
  52.      _a_l_p_h_a     Scalar alpha. (input)
  53.                SSSSCCAALL, CCSSSSCCAALL: Real.
  54.                DDSSCCAALL, ZZDDSSCCAALL: Double precision.
  55.                CCSSCCAALL: Complex.
  56.                ZZSSCCAALL: Double complex.
  57.  
  58.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input and output)
  59.                SSSSCCAALL: Real array.
  60.                DDSSCCAALL: Double precision array.
  61.                CCSSSSCCAALL, CCSSCCAALL: Complex array.
  62.                ZZDDSSCCAALL, ZZSSCCAALL: Double complex array.
  63.                Vector to be scaled.
  64.  
  65.      _i_n_c_x      Integer.  (input)
  66.                Increment between elements of _x.  If _i_n_c_x = 0, the results
  67.                will be unpredictable.
  68.  
  69. NNOOTTEESS
  70.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  71.      BLAS).
  72.  
  73.      When working backward (_i_n_c_x < 0), each routine starts at the end of
  74.      the vector and moves backward, as follows:
  75.  
  76.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  77.  
  78. SSEEEE AALLSSOO
  79.      This man page is available only online.
  80.