array is supported for backward compatibility only and only when T is
* Object.
@@ -87,8 +88,8 @@ public abstract class ArrayUtil {
}
/**
- * Assumes that array contains nulls at the end, only.
- * @returns index of first null, or -1
+ * Assumes that array contains {@code null}s at the end, only.
+ * @returns index of first {@code null}, or -1
*/
private static int findFirstNull(Object[] array) {
boolean haveNull= false;
@@ -117,7 +118,7 @@ public abstract class ArrayUtil {
}
/**
- * Assumes that array contains nulls at the end, only.
+ * Assumes that array contains {@code null}s at the end, only.
* Appends object using the current length of the array.
* @since 5.1
*/
@@ -145,7 +146,7 @@ public abstract class ArrayUtil {
}
/**
- * Assumes that array contains nulls at the end, only.
+ * Assumes that array contains {@code null}s at the end, only.
* Appends object using the current length of the array.
* @param array The array to append to. Not {@code null}
* @param currentLength The number of non-{@code null} elements in the array
@@ -166,12 +167,12 @@ public abstract class ArrayUtil {
}
/**
- * Trims the given array and returns a new array with no null entries.
- * Assumes that nulls can be found at the end, only.
- * if array == null, a new array of length 0 is returned
- * if forceNew == true, a new array will always be created.
- * if forceNew == false, a new array will only be created if the original array
- * contained null entries.
+ * Trims the given array and returns a new array with no {@code null} entries.
+ * Assumes that {@code null}s can be found at the end, only.
+ * if {@code array} is {@code null}, a new array of length 0 is returned
+ * if {@code forceNew} is {@code true}, a new array will always be created.
+ * if {@code forceNew} is {@code false}, a new array will only be created if the original array
+ * contained {@code null} entries.
*
* @param c the type of the new array
* @param array the array to be trimmed
@@ -202,11 +203,11 @@ public abstract class ArrayUtil {
}
/**
- * Trims the given array and returns a new array with no null entries.
- * Assumes that nulls can be found at the end, only.
- * if forceNew == true, a new array will always be created.
- * if forceNew == false, a new array will only be created if the original array
- * contained null entries.
+ * Trims the given array and returns a new array with no {@code null} entries.
+ * Assumes that {@code null}s can be found at the end, only.
+ * if {@code forceNew} is {@code true}, a new array will always be created.
+ * if {@code forceNew} is {@code false}, a new array will only be created if the original array
+ * contained {@code null} entries.
*
* @param array the array to be trimmed
* @param forceNew
@@ -227,8 +228,8 @@ public abstract class ArrayUtil {
}
/**
- * Trims the given array and returns a new array with no null entries.
- * Assumes that nulls can be found at the end, only.
+ * Trims the given array and returns a new array with no {@code null} entries.
+ * Assumes that {@code null}s can be found at the end, only.
*
* @param array the array to be trimmed
* @since 5.2
@@ -257,13 +258,13 @@ public abstract class ArrayUtil {
}
/**
- * Takes contents of the two arrays up to the first null element and concatenates
+ * Takes contents of the two arrays up to the first {@code null} element and concatenates
* them.
* @param c The type of the element of the returned array if there was not enough free space
* in the destination array.
* @param dest The destination array. The elements of the source array are added to this array
- * if there is enough free space in it. May be null.
- * @param source The source array. May not be null.
+ * if there is enough free space in it. May be {@code null}.
+ * @param source The source array. May not be {@code null}.
* @return The concatenated array, which may be the same as the first parameter.
*/
@SuppressWarnings("unchecked")
@@ -300,11 +301,11 @@ public abstract class ArrayUtil {
}
/**
- * Takes contents of the two arrays up to the first null element and concatenates
- * them.
+ * Takes contents of the two arrays up to the first {@code null} element and concatenates them.
+ *
* @param dest The destination array. The elements of the source array are added to this array
- * if there is enough free space in it. May be null.
- * @param source The source array. May not be null.
+ * if there is enough free space in it. May be {@code null}.
+ * @param source The source array. May not be {@code null}.
* @return The concatenated array, which may be the same as the first parameter.
* @since 5.2
*/
@@ -359,10 +360,11 @@ public abstract class ArrayUtil {
/**
* Returns whether the specified array contains the specified object. Comparison is by
* object identity.
+ *
* @param array the array to search
* @param obj the object to search for
* @return true if the specified array contains the specified object, or
- * the specified array is null
+ * the specified array is {@code null}
*/
public static null
+ * not contain the object, or if the array is {@code null}
*/
public static null
+ * {@code null}
*/
public static null
+ * not contain an equal object, or if the array is {@code null}
*/
- public static + * If there are no {@code null}s in the original array then the original array is returned. + *
+ * Note that this method should only be used when the placement of {@code null}s within + * the array is unknown (due to performance efficiency). * @since 5.2 */ @SuppressWarnings("unchecked") @@ -514,11 +521,11 @@ public abstract class ArrayUtil { /** * To improve performance, this method should be used instead of * {@link #removeNulls(Class, Object[])} when all of the non-{@code null} elements in - * the array are grouped together at the beginning of the array and all of the nulls are at - * the end of the array. The position of the last non-{@code null} element in the array must also - * be known. + * the array are grouped together at the beginning of the array and all of the s are at + * the end of the array. The position of the last non-{@code null} element in the array must + * also be known. *
- * If you don't indend to pass {@code null} array, consider using {@link #trim(Object[], int)}
+ * If you don't intend to pass {@code null} array, consider using {@link #trim(Object[], int)}
* instead.
*
* @since 5.1
@@ -536,8 +543,8 @@ public abstract class ArrayUtil {
}
/**
- * Inserts the obj at the beginning of the array, shifting the whole thing one index
- * Assumes that array contains nulls at the end, only.
+ * Inserts the {@code obj} at the beginning of the array, shifting the whole thing one index
+ * Assumes that array contains {@code null}s at the end, only.
*/
@SuppressWarnings("unchecked")
public static This section describes the menubar options available from the C/C++ perspective. null.
+ * Inserts the {@code obj} at the beginning of the array, shifting the whole thing one index
+ * Assumes that array contains {@code null}s at the end, only.
+ * array must not be {@code null}.
* @since 5.2
*/
public static C/C++ Menubar
+alt="C/C++ perspective main menu">
+
File Menu actions
Edit Menu actions
@@ -32,6 +32,8 @@ alt="CDT main menu">
Run Menu actions
Window Menu actions
+
+Help Menu actions (from Workbench User Guide)
+ 
+
| Name | +Function | +Keyboard Shortcut | +
|---|---|---|
| New Window | +Opens a new Workbench window | ++ |
| Name | Function | Keyboard Shortcut |
|---|---|---|
| New Editor | +Opens a new copy of the active editor | ++ |
| New Window | -Opens new Window | -- |
| Open Perspective + (submenu) | +Opens a new perspective (The contents + and order of entries in the submenu are dependent on the current + perspective. The Other... entry allows you to + open any perspective.) + | ++ |
| Show View (submenu) | +Displays a view in the current + perspective (The contents and order of entries in the submenu are + dependent on the current perspective. The Other... + entry allows you to open any view.) + | ++ |
| New Editor | -This command opens a new empty editor in this Workbench window. | -- |
| Customize Perspective... | +Alters the visibility of various + elements of the current perspective | ++ |
| Open Perspective | -This command opens a new perspective in this Workbench window. - This preference can be changed in the Window > Preferences > Workbench > Perspectives page. - All of the perspectives that are open within the Workbench window are shown on the shortcut bar. - The perspectives you will likely want to open are listed first.This list is dependent on the current perspective. - From the Other... submenu you can open any perspective. | -- |
| Show View | -This command displays the selected view in the current perspective. - You can configure how views are opened in the Window > Preferences > Workbench > Perspectives page. - Views you are likely to want to open are listed first.This list is dependent on the current perspective. - From the Other... submenu you can open any view. - The views are sorted into categories in the Show View dialog. | -- |
| Save Perspective As... | +Saves the current perspective under a + new name (It can then be accessed through the Open + Perspective > Other... dialog.) + | ++ |
| Customize Perspective | -Each perspective includes a predefined set of actions that are accessible from the menu bar and Workbench toolbar. - Related actions are grouped into action sets. - This command allows you to customize the current perspective by showing or hiding various action sets. - The first three (File > New, Window > Open Perspective, Window > Show View) control which actions appear as top level items in their respective menus. - The last category (Other) controls which action sets are visible in the perspective. | -- |
| Reset Perspective | +Removes any customizations created by Customize + Perspective... + | ++ |
| Save Perspective As | -This command allows you to save the current perspective, creating your own custom perspective. - You can open more perspectives of this type using the Window > Open Perspective > Other menu item once you have saved a perspective. | -- |
| Close Perspective | +Closes the active perspective | ++ |
| Reset Perspective | -This command changes the layout of the current perspective to its original configuration. | -- |
| Close All Perspectives | +Closes all the open perspectives, which + also closes all the Editors and Views | ++ |
| Close Perspective | -This command closes the active perspective. | -- |
| Navigation | +Navigates between views, perspectives, + and editors in the following ways: + | + |
+
|
+ Alt+(hyphen) | +|
+
|
+ Ctrl-F10 | +|
+
|
+ Ctrl+M | +|
+
|
+ + | |
+
|
+ F12 | +|
| Close All Perspectives | -This command closes all open perspectives in the Workbench window. | -- |
| Navigation | -This submenu contains shortcut keys for navigating between the views, perspectives, and editors in the Workbench window.
-
| - |
| Working sets | -Dialog displayed to edit working sets | -- |
| Preferences | -This command allows you to indicate your preferences for using the Workbench. - There are a wide variety of preferences for configuring the appearance of the Workbench and its views, and for customizing the behavior of all tools that are installed in the Workbench. - See the C/C++ Page Preference Window section for more details on the CDT preferences. | -- |
-
-