2178 * of the resulting array. A zero-width match at the beginning however |
2178 * of the resulting array. A zero-width match at the beginning however |
2179 * never produces such empty leading substring. |
2179 * never produces such empty leading substring. |
2180 * |
2180 * |
2181 * <p> The {@code limit} parameter controls the number of times the |
2181 * <p> The {@code limit} parameter controls the number of times the |
2182 * pattern is applied and therefore affects the length of the resulting |
2182 * pattern is applied and therefore affects the length of the resulting |
2183 * array. If the limit <i>n</i> is greater than zero then the pattern |
2183 * array. |
2184 * will be applied at most <i>n</i> - 1 times, the array's |
2184 * <ul> |
2185 * length will be no greater than <i>n</i>, and the array's last entry |
2185 * <li><p> |
2186 * will contain all input beyond the last matched delimiter. If <i>n</i> |
2186 * If the <i>limit</i> is positive then the pattern will be applied |
2187 * is non-positive then the pattern will be applied as many times as |
2187 * at most <i>limit</i> - 1 times, the array's length will be |
2188 * possible and the array can have any length. If <i>n</i> is zero then |
2188 * no greater than <i>limit</i>, and the array's last entry will contain |
2189 * the pattern will be applied as many times as possible, the array can |
2189 * all input beyond the last matched delimiter.</p></li> |
2190 * have any length, and trailing empty strings will be discarded. |
2190 * |
|
2191 * <li><p> |
|
2192 * If the <i>limit</i> is zero then the pattern will be applied as |
|
2193 * many times as possible, the array can have any length, and trailing |
|
2194 * empty strings will be discarded.</p></li> |
|
2195 * |
|
2196 * <li><p> |
|
2197 * If the <i>limit</i> is negative then the pattern will be applied |
|
2198 * as many times as possible and the array can have any length.</p></li> |
|
2199 * </ul> |
2191 * |
2200 * |
2192 * <p> The string {@code "boo:and:foo"}, for example, yields the |
2201 * <p> The string {@code "boo:and:foo"}, for example, yields the |
2193 * following results with these parameters: |
2202 * following results with these parameters: |
2194 * |
2203 * |
2195 * <blockquote><table class="plain"> |
2204 * <blockquote><table class="plain"> |