home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 6_functions / after < prev    next >
Encoding:
Text File  |  2002-10-28  |  1.3 KB  |  30 lines
  1. Synopsis:
  2.    $after([<count>] <char> <text>)
  3.    $before([<count>] <char> <text>)
  4.  
  5. Technical:
  6.    These functions return their respective input strings up to or following
  7.    the specified occurrence of the given character.  If no "count" is given,
  8.    1 (one) is assumed.  If the count is negative, the functions look for
  9.    the specified instance of the given character from the end of the text.
  10.  
  11. Practical:
  12.    These functions are among the most useful additions to ircII present in
  13.    EPIC.  They conveniently permit you to extract parts of a string based
  14.    on its content, not the position of key characters.  This is useful for
  15.    parsing through a nick!user@host pattern, or some other pattern with
  16.    well-defined delimiters.
  17.  
  18. Returns:
  19.    after:  input text after specified occurrence of given character
  20.    before: input text before specified occurrence of given character
  21.  
  22. Examples:
  23.    $after(@ hop!jnelson@wicked.neato.org)     returns "wicked.neato.org"
  24.    $after(-1 ! hop!jnelson@wicked.neato.org)  returns "hop"
  25.    $after(2 . hop!jnelson@wicked.neato.org)   returns "org"
  26.    $after(-2 . hop!jnelson@wicked.neato.org)  returns "neato.org"
  27.    $before(@ hop!jnelson@wicked.neato.org)    returns "hop!jnelson"
  28.    $before(-1 e hop!jnelson@wicked.neato.org) returns "hop!jnelson@wicked.n"
  29.  
  30.