135 * <p>The <a id="mode">{@code mode}</a> argument specifies the access mode |
135 * <p>The <a id="mode">{@code mode}</a> argument specifies the access mode |
136 * in which the file is to be opened. The permitted values and their |
136 * in which the file is to be opened. The permitted values and their |
137 * meanings are: |
137 * meanings are: |
138 * |
138 * |
139 * <table summary="Access mode permitted values and meanings"> |
139 * <table summary="Access mode permitted values and meanings"> |
140 * <tr><th align="left">Value</th><th align="left">Meaning</th></tr> |
140 * <tr><th style="text-align:left">Value</th><th style="text-align:left">Meaning</th></tr> |
141 * <tr><td valign="top">{@code "r"}</td> |
141 * <tr><td style="vertical-align:top">{@code "r"}</td> |
142 * <td> Open for reading only. Invoking any of the {@code write} |
142 * <td> Open for reading only. Invoking any of the {@code write} |
143 * methods of the resulting object will cause an |
143 * methods of the resulting object will cause an |
144 * {@link java.io.IOException} to be thrown.</td></tr> |
144 * {@link java.io.IOException} to be thrown.</td></tr> |
145 * <tr><td valign="top">{@code "rw"}</td> |
145 * <tr><td style="vertical-align:top">{@code "rw"}</td> |
146 * <td> Open for reading and writing. If the file does not already |
146 * <td> Open for reading and writing. If the file does not already |
147 * exist then an attempt will be made to create it.</td></tr> |
147 * exist then an attempt will be made to create it.</td></tr> |
148 * <tr><td valign="top">{@code "rws"}</td> |
148 * <tr><td style="vertical-align:top">{@code "rws"}</td> |
149 * <td> Open for reading and writing, as with {@code "rw"}, and also |
149 * <td> Open for reading and writing, as with {@code "rw"}, and also |
150 * require that every update to the file's content or metadata be |
150 * require that every update to the file's content or metadata be |
151 * written synchronously to the underlying storage device.</td></tr> |
151 * written synchronously to the underlying storage device.</td></tr> |
152 * <tr><td valign="top">{@code "rwd"}</td> |
152 * <tr><td style="vertical-align:top">{@code "rwd"}</td> |
153 * <td> Open for reading and writing, as with {@code "rw"}, and also |
153 * <td> Open for reading and writing, as with {@code "rw"}, and also |
154 * require that every update to the file's content be written |
154 * require that every update to the file's content be written |
155 * synchronously to the underlying storage device.</td></tr> |
155 * synchronously to the underlying storage device.</td></tr> |
156 * </table> |
156 * </table> |
157 * |
157 * |