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 / swap.z / swap
Encoding:
Text File  |  2002-10-03  |  2.7 KB  |  79 lines
  1. SWAP(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSWWAAPP, DDSSWWAAPP, CCSSWWAAPP, ZZSSWWAAPP - Swaps two real or complex vectors
  6.  
  7. SSYYNNOOPPSSIISS
  8.      Real
  9.  
  10.         CCAALLLL SSSSWWAAPP ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  11.  
  12.      Double precision
  13.  
  14.         CCAALLLL DDSSWWAAPP ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  15.  
  16.      Complex
  17.  
  18.         CCAALLLL CCSSWWAAPP ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  19.  
  20.      Double complex
  21.  
  22.         CCAALLLL ZZSSWWAAPP ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  23.  
  24. IIMMPPLLEEMMEENNTTAATTIIOONN
  25.      IRIX systems
  26.  
  27. DDEESSCCRRIIPPTTIIOONN
  28.      SSSSWWAAPP/DDSSWWAAPP swaps two real vectors.
  29.  
  30.      CCSSWWAAPP/ZZSSWWAAPP swaps two complex vectors.
  31.  
  32.      These routines perform the following vector operation:
  33.  
  34.                _x <-> _y
  35.  
  36.      where _x and _y are real or complex vectors.
  37.  
  38.      These routines have the following arguments:
  39.  
  40.      _n         Integer.  (input)
  41.                Number of vector elements to be swapped.  If _n <= 0, these
  42.                routines return without any computation.
  43.  
  44.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input and output)
  45.                SSSSWWAAPP: Real array.
  46.                DDSSWWAAPP: Double precision array.
  47.                CCSSWWAAPP: Complex array.
  48.                ZZSSWWAAPP: Double complex array.
  49.                Vector to be swapped.
  50.  
  51.      _i_n_c_x      Integer.  (input)
  52.                Increment between elements of _x.
  53.                If _i_n_c_x = 0, the results will be unpredictable.
  54.  
  55.      _y         Array of dimension (_n-1) * |_i_n_c_y| + 1.  (input and output)
  56.                SSSSWWAAPP: Real array.
  57.                DDSSWWAAPP: Double precision array.
  58.                CCSSWWAAPP: Complex array.
  59.                ZZSSWWAAPP: Double complex array.
  60.                Vector to be swapped.
  61.  
  62.      _i_n_c_y      Integer.  (input)
  63.                Increment between elements of _y.  If _i_n_c_y = 0, the results
  64.                will be unpredictable.
  65.  
  66. NNOOTTEESS
  67.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  68.      BLAS).
  69.  
  70.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at
  71.      the end of the vector and moves backward, as follows:
  72.  
  73.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  74.  
  75.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)), ..., _y(1)
  76.  
  77. SSEEEE AALLSSOO
  78.      This man page is available only online.
  79.