find-string

   

  Finds an exact-match string in the buffer and returns its position. If the string is not found, -1 is returned.

• (send a-wx:media-edit find-string str direction start end get-start case-sensitive?) -> small integer
      str : string
      direction = 1 : small integer
      start = -1 : small integer
      end = -1 : small integer
      get-start = #t : boolean
      case-sensitive? = #t : boolean

  The direction argument can be 1 or -1, indicating a forward search or backward search respectively. In the case of a forward search, the return value is the starting position of the string; for a backward search, the ending position is returned. However, if getStart is #f, then the other end of the string position will be returned.

  The start and end arguments set the starting and ending positions of a forward search (use start > end for a backward search). If start is -1, then the search starts at the start of the selection. If end is -1, then the search continues to the end/start of the buffer.

  If case-sensitive? is #f, then an uppercase and lowercase of each alphabetic character are treated as equivalent.