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 / f90 / verify.z / verify
Encoding:
Text File  |  2002-10-03  |  2.5 KB  |  60 lines
  1. VERIFY(3I)                                            Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      VVEERRIIFFYY - Verifies that a set of characters contains all characters in
  6.      a string
  7.  
  8. SSYYNNOOPPSSIISS
  9.      VVEERRIIFFYY (([SSTTRRIINNGG==]_s_t_r_i_n_g,, [SSEETT==]_s_e_t [,,[BBAACCKK==]_b_a_c_k]))
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, IRIX systems
  13.  
  14.      CF90, MIPSpro 7 Fortran 90
  15.  
  16. SSTTAANNDDAARRDDSS
  17.      Fortran
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      The VVEERRIIFFYY intrinsic function verifies that a set of characters
  21.      contains all characters in a string by identifying the first character
  22.      position in a string of characters that does not appear in a given set
  23.      of characters.  VVEERRIIFFYY accepts the following arguments:
  24.  
  25.      _s_t_r_i_n_g    Must be of type character variable.
  26.  
  27.      _s_e_t       Must be of type character variable, expression, or constant.
  28.  
  29.      _b_a_c_k      Must be of type logical.  If _b_a_c_k is omitted, a value of
  30.                false is assumed.
  31.  
  32.      VVEERRIIFFYY is an elemental function.  The name of this intrinsic cannot be
  33.      passed as an argument.
  34.  
  35. RREETTUURRNN VVAALLUUEESS
  36.      The result is an integer.
  37.  
  38.      If _b_a_c_k is absent or is present with a value FFAALLSSEE and _s_t_r_i_n_g contains
  39.      at least one character that is not in _s_e_t, the value of the result is
  40.      the position of the leftmost character of _s_t_r_i_n_g that is not in _s_e_t.
  41.  
  42.      If _b_a_c_k is present with a value TTRRUUEE and if _s_t_r_i_n_g contains at least
  43.      one character that is not in _s_e_t, the value of the result is the
  44.      position of the rightmost character of _s_t_r_i_n_g that is not in _s_e_t.
  45.  
  46.      VVEERRIIFFYY returns 0 if each character in _s_t_r_i_n_g is in _s_e_t, or if the
  47.      length of _s_t_r_i_n_g is 0.
  48.  
  49. EEXXAAMMPPLLEESS
  50.      Example 1:  The statement VVEERRIIFFYY((''AABBBBAA'',, ''AA'')) returns the value 2.
  51.  
  52.      Example 2:  The statement VVEERRIIFFYY((''AABBBBAA'',, ''AA'',, BBAACCKK==..TTRRUUEE..))  returns
  53.      the value 3.
  54.  
  55.      Example 3:  The statement VVEERRIIFFYY((''AABBBBAA'',, ''AABB'')) returns the value 0.
  56.  
  57. SSEEEE AALLSSOO
  58.      _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 for the printed version of this
  59.      man page.
  60.