home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / trim.z / trim
Encoding:
Text File  |  1998-10-30  |  1.9 KB  |  50 lines
  1. TRIM(3I)                                               Last changed: 2-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      TTRRIIMM - Returns the character argument with trailing blank characters
  6.      removed
  7.  
  8. SSYYNNOOPPSSIISS
  9.      TTRRIIMM (([SSTTRRIINNGG==]_s_t_r_i_n_g))
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, and IRIX systems
  13.  
  14. SSTTAANNDDAARRDDSS
  15.      Fortran 90
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The TTRRIIMM intrinsic function removes trailing blank characters from its
  19.      character argument.  If the input string contains trailing blank
  20.      characters, it returns the string without the trailing blanks.  If the
  21.      string contains only blanks, it returns a zero-length string.  It
  22.      accepts the following argument:
  23.  
  24.      _s_t_r_i_n_g    Must be of type character and be a scalar
  25.  
  26.      TTRRIIMM is a transformational function.  The name of this intrinsic
  27.      cannot be passed as an argument.
  28.  
  29. RREETTUURRNN VVAALLUUEESS
  30.      The result is a scalar entity of type character with a length that is
  31.      the length of _s_t_r_i_n_g without any trailing blank characters.  The value
  32.      of the result is the same as _s_t_r_i_n_g except that any trailing blanks
  33.      have been removed.  If _s_t_r_i_n_g contains only blank characters, the
  34.      result is a string of 0 length.
  35.  
  36. EEXXAAMMPPLLEESS
  37.      Consider the following example of a TTRRIIMM function reference.  In this
  38.      example, the carat (^^) represents a blank:
  39.  
  40.           CHVAR = TRIM( '^W^O^R^D^^' )
  41.           PRINT *,"CHVAR='",CHVAR,"'"
  42.  
  43.      This reference returns the following result:
  44.  
  45.           CHVAR='^W^O^R^D'
  46.  
  47. SSEEEE AALLSSOO
  48.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  49.      printed version of this man page.
  50.