| OLD | NEW |
| 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 part of dart.core; | 5 part of dart.core; |
| 6 | 6 |
| 7 /** |
| 8 * An interface for basic searches within strings. |
| 9 */ |
| 7 abstract class Pattern { | 10 abstract class Pattern { |
| 8 /** | 11 /** |
| 9 * Match this pattern against the string repeatedly. | 12 * Match this pattern against the string repeatedly. |
| 10 * | 13 * |
| 11 * The iterable will contain all the non-overlapping matches of the | 14 * The iterable will contain all the non-overlapping matches of the |
| 12 * pattern on the string, ordered by start index. | 15 * pattern on the string, ordered by start index. |
| 13 * | 16 * |
| 14 * The matches are found by repeatedly finding the first match | 17 * The matches are found by repeatedly finding the first match |
| 15 * of the pattern on the string, starting from the end of the previous | 18 * of the pattern on the string, starting from the end of the previous |
| 16 * match, and initially starting from index zero. | 19 * match, and initially starting from index zero. |
| 17 * | 20 * |
| 18 * If the pattern matches the empty string at some point, the next | 21 * If the pattern matches the empty string at some point, the next |
| 19 * match is found by starting at the previous match's end plus one. | 22 * match is found by starting at the previous match's end plus one. |
| 20 */ | 23 */ |
| 21 Iterable<Match> allMatches(String str); | 24 Iterable<Match> allMatches(String str); |
| 22 | 25 |
| 23 /** | 26 /** |
| 24 * Match this pattern against the start of string. | 27 * Match this pattern against the start of string. |
| 25 * | 28 * |
| 26 * If [start] is provided, it must be an integer in the range `0` .. | 29 * If [start] is provided, it must be an integer in the range `0` .. |
| 27 * `string.length`. In that case, this patten is tested against the | 30 * `string.length`. In that case, this patten is tested against the |
| 28 * string at the [start] position. That is, a match is returned if the | 31 * string at the [start] position. That is, a match is returned if the |
| 29 * pattern can match a part of the string starting from position [start]. | 32 * pattern can match a part of the string starting from position [start]. |
| 30 */ | 33 */ |
| 31 Match matchAsPrefix(String string, [int start = 0]); | 34 Match matchAsPrefix(String string, [int start = 0]); |
| 32 } | 35 } |
| OLD | NEW |