paren:forward-match

• (paren:forward-match text start end parens quotes comments cache) -> (union #f integer)
      text : (instance text%)
      start : exact-integer
      end : exact-integer
      parens : (listof (cons string string))
      quotes : (listof (cons string string))
      comments : (listof string)
      cache : (union #f (instance match-cache:%))

  This function returns the position in text that ``closes'' the text at start, or #f if no closing position is found (either because a parenthesis mis-match is discovered or the end boundary was reached). The match must occur before end (inclusive).

  Spaces immediately following start are skipped. If the text at start is an open parenthesis or open quote, then the matching position is the closing parenthesis or quote. If a comment immediately follows start, it is skipped over as whitespace. If a closing parenthesis immediately follows start (after skipping whitespace), then #f is returned. Otherwise, the matching position is the position before the first whitespace, parenthesis, quote, or comment character after start.

  If cache is not #f, it must be an instance of match-cache:%. A cache object can be used to speed up successive calls to paren:forwardward-match. However, a buffer using a cache must call the cache's forward-invalidate method when the buffer is modified. Different caches should be used for forward and backward matching. See the match cache section for more information.