Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
New Bidi APIs
In Eclipse 3.2, new APIs were added to provide proper rendering of strings containing bidirectional text that have implicit left to right semantic meaning. The method org.eclipse.osgi.util.TextProcessor.process(String str, String delimiter) provides this function.
- str
- the string to process
- delimiter
- a string of characters used to segment the string.
The text of each segment has directional markers inserted at the beginning and end of it to ensure the entire string is rendered left-to-right and also has the Unicode Bidirectional algorithm applied to it in order to render the mixed text of the segment in the proper orientation.
As an example, a file path such as
d:\myFolder\FOLDER\MYFILE.java
(where capital letters indicate RTL-oriented text) should render as
d:\myFolder\REDLOF\ELIFYM.java
when using the Unicode Bidi algorithm and segmenting the string according to a specified delimiter set. However, since the OS does not understand that the string should be segmented according to each segment of the file path, it uses the Bidirectional algorithm to renders the string as follows:
java.ELIFYM\REDLOF\d:\myFolder
Types of strings to which this API should be applied are:
- File paths (e.g. d:\myFolder\abc\DEF)
- URLs (e.g. http://abc/DEF)
- File names with extensions (e.g. ABC.java)
- File associations (e.g. *.java, *.ABC)