Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 36cd87d0 authored by Roozbeh Pournader's avatar Roozbeh Pournader
Browse files

Unhide CharSequence APIs to BidiFormatter 

The APIs are useful in avoiding the unnecessary creation of strings
when you have a CharSequence that's not a String.

Bug: 26979409
Change-Id: I27cd157ca53edb5f44a1e69085a1882af3cc7c6a
parent 078c5e00

api/current.txt

+5 −0
Original line number Diff line number Diff line
@@ -38280,11 +38280,16 @@ package android.text { 
    method public static android.text.BidiFormatter getInstance(java.util.Locale);

    method public boolean getStereoReset();

    method public boolean isRtl(java.lang.String);

    method public boolean isRtl(java.lang.CharSequence);

    method public boolean isRtlContext();

    method public java.lang.String unicodeWrap(java.lang.String, android.text.TextDirectionHeuristic, boolean);

    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, android.text.TextDirectionHeuristic, boolean);

    method public java.lang.String unicodeWrap(java.lang.String, android.text.TextDirectionHeuristic);

    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, android.text.TextDirectionHeuristic);

    method public java.lang.String unicodeWrap(java.lang.String, boolean);

    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, boolean);

    method public java.lang.String unicodeWrap(java.lang.String);

    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence);

  }















  public static final class BidiFormatter.Builder {

























api/system-current.txt



+5
−0






























Original line number
Diff line number
Diff line








@@ -41278,11 +41278,16 @@ package android.text {













    method public static android.text.BidiFormatter getInstance(java.util.Locale);















    method public boolean getStereoReset();















    method public boolean isRtl(java.lang.String);













    method public boolean isRtl(java.lang.CharSequence);















    method public boolean isRtlContext();















    method public java.lang.String unicodeWrap(java.lang.String, android.text.TextDirectionHeuristic, boolean);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, android.text.TextDirectionHeuristic, boolean);















    method public java.lang.String unicodeWrap(java.lang.String, android.text.TextDirectionHeuristic);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, android.text.TextDirectionHeuristic);















    method public java.lang.String unicodeWrap(java.lang.String, boolean);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, boolean);















    method public java.lang.String unicodeWrap(java.lang.String);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence);















  }





























  public static final class BidiFormatter.Builder {

























api/test-current.txt



+5
−0






























Original line number
Diff line number
Diff line








@@ -38360,11 +38360,16 @@ package android.text {













    method public static android.text.BidiFormatter getInstance(java.util.Locale);















    method public boolean getStereoReset();















    method public boolean isRtl(java.lang.String);













    method public boolean isRtl(java.lang.CharSequence);















    method public boolean isRtlContext();















    method public java.lang.String unicodeWrap(java.lang.String, android.text.TextDirectionHeuristic, boolean);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, android.text.TextDirectionHeuristic, boolean);















    method public java.lang.String unicodeWrap(java.lang.String, android.text.TextDirectionHeuristic);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, android.text.TextDirectionHeuristic);















    method public java.lang.String unicodeWrap(java.lang.String, boolean);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence, boolean);















    method public java.lang.String unicodeWrap(java.lang.String);













    method public java.lang.CharSequence unicodeWrap(java.lang.CharSequence);















  }





























  public static final class BidiFormatter.Builder {

























core/java/android/text/BidiFormatter.java



+34
−5






























Original line number
Diff line number
Diff line








@@ -355,7 +355,11 @@ public final class BidiFormatter {













    }































    /**













     * @hide













     * Operates like {@link #isRtl(String)}, but takes a CharSequence instead of a string













     *













     * @param str CharSequence whose directionality is to be estimated.













     * @return true if {@code str}'s estimated overall directionality is RTL. Otherwise returns













     *          false.















     */















    public boolean isRtl(CharSequence str) {















        return mDefaultTextDirectionHeuristic.isRtl(str, 0, str.length());










@@ -398,7 +402,16 @@ public final class BidiFormatter {













    }































    /**













     * @hide













     * Operates like {@link #unicodeWrap(String, TextDirectionHeuristic, boolean)}, but takes a













     * CharSequence instead of a string













     *













     * @param str The input CharSequence.













     * @param heuristic The algorithm to be used to estimate the CharSequence's overall direction.













     *        See {@link TextDirectionHeuristics} for pre-defined heuristics.













     * @param isolate Whether to directionally isolate the CharSequence to prevent it from garbling













     *     the content around it













     * @return Input CharSequence after applying the above processing. {@code null} if {@code str}













     *     is {@code null}.















     */















    public @Nullable CharSequence unicodeWrap(@Nullable CharSequence str,















            TextDirectionHeuristic heuristic, boolean isolate) {










@@ -437,7 +450,13 @@ public final class BidiFormatter {













    }































    /**













     * @hide













     * Operates like {@link #unicodeWrap(CharSequence, TextDirectionHeuristic, boolean)}, but













     * assumes {@code isolate} is true.













     *













     * @param str The input CharSequence.













     * @param heuristic The algorithm to be used to estimate the CharSequence's overall direction.













     *        See {@link TextDirectionHeuristics} for pre-defined heuristics.













     * @return Input CharSequence after applying the above processing.















     */















    public CharSequence unicodeWrap(CharSequence str, TextDirectionHeuristic heuristic) {















        return unicodeWrap(str, heuristic, true /* isolate */);









@@ -458,7 +477,13 @@ public final class BidiFormatter {













    }































    /**













     * @hide













     * Operates like {@link #unicodeWrap(CharSequence, TextDirectionHeuristic, boolean)}, but uses













     * the formatter's default direction estimation algorithm.













     *













     * @param str The input CharSequence.













     * @param isolate Whether to directionally isolate the CharSequence to prevent it from garbling













     *     the content around it













     * @return Input CharSequence after applying the above processing.















     */















    public CharSequence unicodeWrap(CharSequence str, boolean isolate) {















        return unicodeWrap(str, mDefaultTextDirectionHeuristic, isolate);









@@ -476,7 +501,11 @@ public final class BidiFormatter {













    }































    /**













     * @hide













     * Operates like {@link #unicodeWrap(CharSequence, TextDirectionHeuristic, boolean)}, but uses













     * the formatter's default direction estimation algorithm and assumes {@code isolate} is true.













     *













     * @param str The input CharSequence.













     * @return Input CharSequence after applying the above processing.















     */















    public CharSequence unicodeWrap(CharSequence str) {















        return unicodeWrap(str, mDefaultTextDirectionHeuristic, true /* isolate */);