1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
/* GENERATED SOURCE. DO NOT MODIFY. */
/*
*******************************************************************************
* Copyright (C) 2014, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*/
package android.icu.text;
import android.icu.impl.SimpleFilteredSentenceBreakIterator;
import android.icu.util.ULocale;
/**
* The BreakIteratorFilter is used to modify the behavior of a BreakIterator
* by constructing a new BreakIterator which suppresses certain segment boundaries.
* See http://www.unicode.org/reports/tr35/tr35-general.html#Segmentation_Exceptions .
* For example, a typical English Sentence Break Iterator would break on the space
* in the string "Mr. Smith" (resulting in two segments),
* but with "Mr." as an exception, a filtered break iterator
* would consider the string "Mr. Smith" to be a single segment.
*
* <p><b>Note:</b> An instance of {@link BreakIterator} returned by this builder
* class currently does not support following operations in this technology preview
* version:
* <ul>
* <li>{@link BreakIterator#next(int) next(int n)}</li>
* <li>{@link BreakIterator#previous() previous()}</li>
* <li>{@link BreakIterator#following(int) following(int offset)}</li>
* <li>{@link BreakIterator#preceding(int) preceding(int offset)}</li>
* </ul>
* When one of above methods is called, {@link UnsupportedOperationException} will be
* thrown.
*
* @author tomzhang
*
* @deprecated This API might change or be removed in a future release.
* @hide Only a subset of ICU is exposed in Android
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
public abstract class FilteredBreakIteratorBuilder {
/**
* Construct a FilteredBreakIteratorBuilder based on rules in a locale.
* The rules are taken from CLDR exception data for the locale,
* see http://www.unicode.org/reports/tr35/tr35-general.html#Segmentation_Exceptions
* This is the equivalent of calling createInstance(UErrorCode&)
* and then repeatedly calling addNoBreakAfter(...) with the contents
* of the CLDR exception data.
* @param where the locale.
* @return the new builder
* @deprecated This API might change or be removed in a future release.
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
public static FilteredBreakIteratorBuilder createInstance(ULocale where) {
FilteredBreakIteratorBuilder ret = new SimpleFilteredSentenceBreakIterator.Builder(where);
return ret;
}
/**
* Construct an empty FilteredBreakIteratorBuilder.
* In this state, it will not suppress any segment boundaries.
* @return the new builder
* @deprecated This API might change or be removed in a future release.
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
public static FilteredBreakIteratorBuilder createInstance() {
FilteredBreakIteratorBuilder ret = new SimpleFilteredSentenceBreakIterator.Builder();
return ret;
}
/**
* Suppress a certain string from being the end of a segment.
* For example, suppressing "Mr.", then segments ending in "Mr." will not be returned
* by the iterator.
* @param str the string to suppress, such as "Mr."
* @return returns true if the string was not present and now added,
* false if the call was a no-op because the string was already being suppressed.
* @deprecated This API might change or be removed in a future release.
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
public abstract boolean suppressBreakAfter(String str);
/**
* Stop suppressing a certain string from being the end of the segment.
* This function does not create any new segment boundaries, but only serves to un-do
* the effect of earlier calls to suppressBreakAfter, or to un-do the effect of
* locale data which may be suppressing certain strings.
* @param str the str the string to unsuppress, such as "Mr."
* @return returns true if the string was present and now removed,
* false if the call was a no-op because the string was not being suppressed.
* @deprecated This API might change or be removed in a future release.
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
public abstract boolean unsuppressBreakAfter(String str);
/**
* Wrap (adopt) an existing break iterator in a new filtered instance.
* The resulting BreakIterator is owned by the caller.
* The BreakIteratorFilter may be destroyed before the BreakIterator is destroyed.
* Note that the adoptBreakIterator is adopted by the new BreakIterator
* and should no longer be used by the caller.
* The FilteredBreakIteratorBuilder may be reused.
* @param adoptBreakIterator the break iterator to adopt
* @return the new BreakIterator, owned by the caller.
* @deprecated This API might change or be removed in a future release.
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
public abstract BreakIterator build(BreakIterator adoptBreakIterator);
/**
* For subclass use
* @deprecated This API might change or be removed in a future release.
* @hide draft / provisional / internal are hidden on Android
*/
@Deprecated
protected FilteredBreakIteratorBuilder() {}
}
|
