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 / left < prev    next >
Encoding:
Text File  |  2002-10-28  |  937 b   |  29 lines
  1. Synopsis:
  2.    $left(<count> <text>)
  3.    $right(<count> <text>)
  4.  
  5. Technical:
  6.    These functions return a slice of the given length from the input
  7.    string, either from the left side or the right side of the string.  The
  8.    functions do no padding, so it is more accurate to say that they will
  9.    return no more than the given number of characters, not necessarily
  10.    exactly the given amount.
  11.  
  12. Practical:
  13.    The most common use for these functions is fetching a certain number of
  14.    characters from an arbitrary string, where the length is known, but the
  15.    contents are inconsequential.
  16.  
  17. Returns:
  18.    substring no longer than specified length
  19.  
  20. Examples:
  21.    $left(5 biklmnopstv)                     returns "biklm"
  22.    $left(15 biklmnopstv)                    returns "biklmnopstv"
  23.    $left(-2 biklmnopstv)                    returns nothing
  24.    $right(5 biklmnopstv)                    returns "opstv"
  25.  
  26. See Also:
  27.    mid(6)
  28.  
  29.