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 / leftw < prev    next >
Encoding:
Text File  |  2002-10-28  |  955 b   |  28 lines
  1. Synopsis:
  2.    $leftw(<count> <word list>)
  3.    $rightw(<count> <word list>)
  4.  
  5. Technical:
  6.    These functions are used to return a slice of the input list, from either
  7.    the beginning or end of the list.  It returns the indicated number of
  8.    words from the beginning or the end of the list.
  9.  
  10. Practical:
  11.    This is mostly useful when you know you always want to get a certain
  12.    number of starting or ending words in a list, regardless of what they
  13.    are.  They are analogous to $left() and $right(), except they operate on
  14.    whole words instead of characters.
  15.  
  16. Returns:
  17.    list of words from beginning or end of word list
  18.  
  19. Examples:
  20.    $leftw(2 hello there how are you?)         returns "hello there"
  21.    $leftw(-1 hello there bob)                 returns nothing
  22.    $leftw(7 hello there bob)                  returns "hello there bob"
  23.    $rightw(2 hello there how are you?)        returns "are you?"
  24.  
  25. See Also:
  26.    midw(6); restw(6)
  27.  
  28.