diff --git a/README.md b/README.md index d580665..a8fe773 100644 --- a/README.md +++ b/README.md @@ -162,7 +162,7 @@ This creates a `FileXT` object i.e. with `isTraditional` = true even though the | renameTo(dest: FileX) | Boolean | - | Move the current document to the path mentioned by the FileX parameter `dest`
For `FileX11` this only works for Android 7+ (API 24) due to Android limitations. | | renameTo(newFileName: String) | Boolean | - | Rename the document in place. This is used to only change the name and cannot move the document. | | inputStream() | InputStream? | - | Returns an `InputStream` to the document to write to. | -| outputStream() | OutputStream? | - | Returns an `OutputStream` to the document to read from. | +| outputStream(mode:String="w") | OutputStream? | - | Returns an `OutputStream` to the document to read from.

The `mode` argument is mainly useful for `FileX11`. It can be
`"r"` for read-only access,
`"w"` for write-only access (erasing whatever data is currently in the file),
`"wa"` for write-only access to append to any existing data,
`"rw"` for read and write access on any existing data,
and `"rwt"` for read and write access that truncates any existing file.

For `FileXT`, pass `"wa"` to get a `FileOutputStream` in append mode. | | list() | Array-String? | - | Returns a String array of all the contents of a directory. | | list(filter: FileXFilter) | Array-String? | - | Returns the list filtering with a `FileXFilter`. This is similar to `FileFilter` in Java. | | list(filter: FileXNameFilter) | Array-String? | - | Returns the list filtering with a `FileXNameFilter`. This is similar to `FilenameFilter` in Java. | diff --git a/doc_assets/FileX_methods.tgn b/doc_assets/FileX_methods.tgn index 4e43a23..61f54b0 100644 --- a/doc_assets/FileX_methods.tgn +++ b/doc_assets/FileX_methods.tgn @@ -1 +1 @@ -{"rows_views":[[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}]],"model":{"rows":[[{"value":"Method name","cspan":1,"rspan":1,"markup":[1,11]},{"value":"Return type\n(`?` - null return possible)","cspan":1,"rspan":1,"markup":[1,13,3,3,1,24]},{"value":"Exclusively for","cspan":1,"rspan":1,"markup":[1,15]},{"value":"Description","cspan":1,"rspan":1,"markup":[1,11]}],[{"value":"refreshFile()","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"FileX11\n(`isTraditional`\n=false)","cspan":1,"rspan":1,"markup":[1,9,3,15,1,8]},{"value":"Not required by `FileXT`\n\n\nIf the document was not present during declaration of the FileX object, and the document is later created by any other app, then call `refreshFile()` on it to update the Uri pointing to the file.\nDo note that if your app is itself creating the document, you need not call `refreshFile()` again.\n\nExample:\n\n`val fx1 = FileX.new(\"aFile\")`\n`val fx2 = FileX.new(\"/aFile\")`\n`fx2.createNewFile()`\n\nIn this case you need not call `refreshFile()` on `fx1`. However if any other app creates the document, then you will not be able to refer to it unless the file is refreshed.","cspan":1,"rspan":1,"markup":[0,3,1,16,3,8,0,7,1,134,3,15,1,123,3,15,1,7,0,2,1,8,0,2,3,30,1,1,3,31,1,1,3,21,0,2,1,31,3,15,1,4,3,5,1,119]}],[{"value":"exists()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns if the document exist. For `FileX11`, internally calls `refreshFile()` before checking.","cspan":1,"rspan":1,"markup":[1,35,3,9,1,19,3,15,1,17]}],[{"value":"length()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Long","cspan":1,"rspan":1,"markup":[1,4]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Length of the file in bytes.","cspan":1,"rspan":1,"markup":[1,28]}],[{"value":"lastModified()","cspan":1,"rspan":1,"markup":[1,14]},{"value":"Long","cspan":1,"rspan":1,"markup":[1,4]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Value representing the time the file was last modified, measured in milliseconds since the epoch (00:00:00 GMT, January 1, 1970)","cspan":1,"rspan":1,"markup":[1,128]}],[{"value":"canRead()","cspan":1,"rspan":1,"markup":[1,9]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns if the document can be read from. Usually always true for `FileX11`.","cspan":1,"rspan":1,"markup":[1,66,3,9,1,1]}],[{"value":"canWrite()","cspan":1,"rspan":1,"markup":[1,10]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns if the document can be written to. Usually always true for `FileX11`.","cspan":1,"rspan":1,"markup":[1,67,3,9,1,1]}],[{"value":"canExecute()","cspan":1,"rspan":1,"markup":[1,12]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"FileXT\n(`isTraditional`\n=true)","cspan":1,"rspan":1,"markup":[1,8,3,15,1,7]},{"value":"Returns if the Java File pointed by a FileX object is executable. Always false for `FileX11`.","cspan":1,"rspan":1,"markup":[1,83,3,9,1,1]}],[{"value":"delete()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Deletes a single document. Does not delete a directory. Returns true if successful, else false.","cspan":1,"rspan":1,"markup":[1,95]}],[{"value":"deleteRecursively()","cspan":1,"rspan":1,"markup":[1,19]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Deletes a directory and all documents and other directories inside it. Returns true if successful.","cspan":1,"rspan":1,"markup":[1,98]}],[{"value":"deleteOnExit()","cspan":1,"rspan":1,"markup":[1,14]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"FileXT\n(`isTraditional`\n=true)","cspan":1,"rspan":1,"markup":[1,8,3,15,1,7]},{"value":"Requests that the file or directory denoted by this abstract pathname be deleted when the virtual machine terminates.\nSame as `java.io.File.deleteOnExit()`","cspan":1,"rspan":1,"markup":[1,126,3,29]}],[{"value":"createNewFile()","cspan":1,"rspan":1,"markup":[1,15]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Creates document referred to by the FileX object. Throws error if the whole directory path is not present.\nA safer alternative is a new variant of the method described below.","cspan":1,"rspan":1,"markup":[1,174]}],[{"value":"createNewFile(\n  makeDirectories:Boolean=false, \n  overwriteIfExists:Boolean=false, \n  optionalMimeType:String\n)","cspan":1,"rspan":1,"markup":[1,112]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Create a document.\nIf `makeDirectories` = true (Default: false) -> Creates the whole directory tree before the document if not present.\nIf `overwriteIfExist` = true (Default: false) -> Deletes the document if already present and creates a blank document.\nFor `FileX11`:\n`optionalMimeType` as string can be specified. Ignored for `FileXT`\n\nReturns true, if document creation is successful.","cspan":1,"rspan":1,"markup":[1,22,3,17,1,100,3,18,1,102,3,9,1,2,3,18,1,41,3,8,0,2,1,49]}],[{"value":"createFileUsingPicker(\n  optionalMimeType: String,\n  afterJob:\n    (resultCode: Int, data: Intent?)\n)","cspan":1,"rspan":1,"markup":[1,101]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"FileX11\n(`isTraditional`\n=false)","cspan":1,"rspan":1,"markup":[1,9,3,15,1,8]},{"value":"Invoke the System file picker to create the file. Only applicable on `FileX11`\n\nmime type can be spcified in `optionalMimeType`\n`afterJob()` - custom function can be passed to execute after document is created.\n    `resultCode` = `Activity.RESULT_OK` if document is successfully created.\n    `data` = Intent data returned by System after document creation.","cspan":1,"rspan":1,"markup":[1,69,3,9,0,2,1,29,3,18,1,1,3,12,1,75,3,12,1,3,3,20,1,42,3,6,1,58]}],[{"value":"mkdirs()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Make all directories specified by the path of the FileX object (including the last element of the path and other non-existing parent directories.).","cspan":1,"rspan":1,"markup":[1,147]}],[{"value":"mkdir()","cspan":1,"rspan":1,"markup":[1,7]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Creates only the last element of the path as a directory. Parent directories must be already present.","cspan":1,"rspan":1,"markup":[1,101]}],[{"value":"renameTo(dest: FileX)","cspan":1,"rspan":1,"markup":[1,21]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Move the current document to the path mentioned by the FileX parameter `dest`\nFor `FileX11` this only works for Android 7+ (API 24) due to Android limitations.","cspan":1,"rspan":1,"markup":[1,71,3,6,1,5,3,9,1,68]}],[{"value":"renameTo(newFileName: String)","cspan":1,"rspan":1,"markup":[1,29]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Rename the document in place. This is used to only change the name and cannot move the document.","cspan":1,"rspan":1,"markup":[1,96]}],[{"value":"inputStream()","cspan":1,"rspan":1,"markup":[1,13]},{"value":"InputStream?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns an `InputStream` to the document to write to.","cspan":1,"rspan":1,"markup":[1,11,3,13,1,29]}],[{"value":"outputStream()","cspan":1,"rspan":1,"markup":[1,14]},{"value":"OutputStream?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns an `OutputStream` to the document to read from.","cspan":1,"rspan":1,"markup":[1,11,3,14,1,30]}],[{"value":"list()","cspan":1,"rspan":1,"markup":[1,6]},{"value":"Array-String?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns a String array of all the contents of a directory.","cspan":1,"rspan":1,"markup":[1,58]}],[{"value":"list(filter: FileXFilter)","cspan":1,"rspan":1,"markup":[1,25]},{"value":"Array-String?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns the list filtering with a `FileXFilter`. This is similar to `FileFilter` in Java.","cspan":1,"rspan":1,"markup":[1,34,3,13,1,21,3,12,1,9]}],[{"value":"list(filter: FileXNameFilter)","cspan":1,"rspan":1,"markup":[1,29]},{"value":"Array-String?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns the list filtering with a `FileXNameFilter`. This is similar to `FilenameFilter` in Java.","cspan":1,"rspan":1,"markup":[1,34,3,17,1,21,3,16,1,9]}],[{"value":"listFiles()","cspan":1,"rspan":1,"markup":[1,11]},{"value":"Array-FileX?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns an array of FileX pointing to all the contents of a directory.","cspan":1,"rspan":1,"markup":[1,70]}],[{"value":"listFiles(filter: FileXFilter)","cspan":1,"rspan":1,"markup":[1,30]},{"value":"Array-FileX?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns FileX elements array filtering with a `FileXFilter`.","cspan":1,"rspan":1,"markup":[1,46,3,13,1,1]}],[{"value":"listFiles(filter: FileXNameFilter)","cspan":1,"rspan":1,"markup":[1,34]},{"value":"Array-FileX?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns FileX elements array filtering with a `FileXNameFilter`.","cspan":1,"rspan":1,"markup":[1,46,3,17,1,1]}],[{"value":"copyTo(\n  target:FileX,\n  overwrite:Boolean=false,\n  bufferSize:Int\n)","cspan":1,"rspan":1,"markup":[1,69]},{"value":"FileX","cspan":1,"rspan":1,"markup":[1,5]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Copies a file and returns the target. Logic is completely copied from File.copyTo() of kotlin.io.","cspan":1,"rspan":1,"markup":[1,97]}],[{"value":"copyRecursively(\n  target:FileX,\n  overwrite:Boolean=false,\n  onError:\n    (FileX, Exception)\n)","cspan":1,"rspan":1,"markup":[1,95]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Directory copy recursively, return true if success else false.\nLogic is completely copied from File.copyRecursively() of kotlin.io.","cspan":1,"rspan":1,"markup":[1,131]}]]},"theme":null,"fixed_layout":false,"markup":{"instances":[{},{"style":{}},null,{"style":{"color":"#905","backgroundColor":"#ddd"}},null]},"options":{}} \ No newline at end of file +{"rows_views":[[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}],[{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}},{"style":{"borders":"lrtb","font_style":{},"text_color":"","bg_color":"","halign":"left","valign":"top","padding":{"top":10,"right":5,"bottom":10,"left":5},"border_color":""}}]],"model":{"rows":[[{"value":"Method name","cspan":1,"rspan":1,"markup":[1,11]},{"value":"Return type\n(`?` - null return possible)","cspan":1,"rspan":1,"markup":[1,13,3,3,1,24]},{"value":"Exclusively for","cspan":1,"rspan":1,"markup":[1,15]},{"value":"Description","cspan":1,"rspan":1,"markup":[1,11]}],[{"value":"refreshFile()","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"FileX11\n(`isTraditional`\n=false)","cspan":1,"rspan":1,"markup":[1,9,3,15,1,8]},{"value":"Not required by `FileXT`\n\n\nIf the document was not present during declaration of the FileX object, and the document is later created by any other app, then call `refreshFile()` on it to update the Uri pointing to the file.\nDo note that if your app is itself creating the document, you need not call `refreshFile()` again.\n\nExample:\n\n`val fx1 = FileX.new(\"aFile\")`\n`val fx2 = FileX.new(\"/aFile\")`\n`fx2.createNewFile()`\n\nIn this case you need not call `refreshFile()` on `fx1`. However if any other app creates the document, then you will not be able to refer to it unless the file is refreshed.","cspan":1,"rspan":1,"markup":[0,3,1,16,3,8,0,7,1,134,3,15,1,123,3,15,1,7,0,2,1,8,0,2,3,30,1,1,3,31,1,1,3,21,0,2,1,31,3,15,1,4,3,5,1,119]}],[{"value":"exists()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns if the document exist. For `FileX11`, internally calls `refreshFile()` before checking.","cspan":1,"rspan":1,"markup":[1,35,3,9,1,19,3,15,1,17]}],[{"value":"length()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Long","cspan":1,"rspan":1,"markup":[1,4]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Length of the file in bytes.","cspan":1,"rspan":1,"markup":[1,28]}],[{"value":"lastModified()","cspan":1,"rspan":1,"markup":[1,14]},{"value":"Long","cspan":1,"rspan":1,"markup":[1,4]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Value representing the time the file was last modified, measured in milliseconds since the epoch (00:00:00 GMT, January 1, 1970)","cspan":1,"rspan":1,"markup":[1,128]}],[{"value":"canRead()","cspan":1,"rspan":1,"markup":[1,9]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns if the document can be read from. Usually always true for `FileX11`.","cspan":1,"rspan":1,"markup":[1,66,3,9,1,1]}],[{"value":"canWrite()","cspan":1,"rspan":1,"markup":[1,10]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns if the document can be written to. Usually always true for `FileX11`.","cspan":1,"rspan":1,"markup":[1,67,3,9,1,1]}],[{"value":"canExecute()","cspan":1,"rspan":1,"markup":[1,12]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"FileXT\n(`isTraditional`\n=true)","cspan":1,"rspan":1,"markup":[1,8,3,15,1,7]},{"value":"Returns if the Java File pointed by a FileX object is executable. Always false for `FileX11`.","cspan":1,"rspan":1,"markup":[1,83,3,9,1,1]}],[{"value":"delete()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Deletes a single document. Does not delete a directory. Returns true if successful, else false.","cspan":1,"rspan":1,"markup":[1,95]}],[{"value":"deleteRecursively()","cspan":1,"rspan":1,"markup":[1,19]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Deletes a directory and all documents and other directories inside it. Returns true if successful.","cspan":1,"rspan":1,"markup":[1,98]}],[{"value":"deleteOnExit()","cspan":1,"rspan":1,"markup":[1,14]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"FileXT\n(`isTraditional`\n=true)","cspan":1,"rspan":1,"markup":[1,8,3,15,1,7]},{"value":"Requests that the file or directory denoted by this abstract pathname be deleted when the virtual machine terminates.\nSame as `java.io.File.deleteOnExit()`","cspan":1,"rspan":1,"markup":[1,126,3,29]}],[{"value":"createNewFile()","cspan":1,"rspan":1,"markup":[1,15]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Creates document referred to by the FileX object. Throws error if the whole directory path is not present.\nA safer alternative is a new variant of the method described below.","cspan":1,"rspan":1,"markup":[1,174]}],[{"value":"createNewFile(\n  makeDirectories:Boolean=false, \n  overwriteIfExists:Boolean=false, \n  optionalMimeType:String\n)","cspan":1,"rspan":1,"markup":[1,112]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Create a document.\nIf `makeDirectories` = true (Default: false) -> Creates the whole directory tree before the document if not present.\nIf `overwriteIfExist` = true (Default: false) -> Deletes the document if already present and creates a blank document.\nFor `FileX11`:\n`optionalMimeType` as string can be specified. Ignored for `FileXT`\n\nReturns true, if document creation is successful.","cspan":1,"rspan":1,"markup":[1,22,3,17,1,100,3,18,1,102,3,9,1,2,3,18,1,41,3,8,0,2,1,49]}],[{"value":"createFileUsingPicker(\n  optionalMimeType: String,\n  afterJob:\n    (resultCode: Int, data: Intent?)\n)","cspan":1,"rspan":1,"markup":[1,101]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"FileX11\n(`isTraditional`\n=false)","cspan":1,"rspan":1,"markup":[1,9,3,15,1,8]},{"value":"Invoke the System file picker to create the file. Only applicable on `FileX11`\n\nmime type can be spcified in `optionalMimeType`\n`afterJob()` - custom function can be passed to execute after document is created.\n    `resultCode` = `Activity.RESULT_OK` if document is successfully created.\n    `data` = Intent data returned by System after document creation.","cspan":1,"rspan":1,"markup":[1,69,3,9,0,2,1,29,3,18,1,1,3,12,1,75,3,12,1,3,3,20,1,42,3,6,1,58]}],[{"value":"mkdirs()","cspan":1,"rspan":1,"markup":[1,8]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Make all directories specified by the path of the FileX object (including the last element of the path and other non-existing parent directories.).","cspan":1,"rspan":1,"markup":[1,147]}],[{"value":"mkdir()","cspan":1,"rspan":1,"markup":[1,7]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Creates only the last element of the path as a directory. Parent directories must be already present.","cspan":1,"rspan":1,"markup":[1,101]}],[{"value":"renameTo(dest: FileX)","cspan":1,"rspan":1,"markup":[1,21]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Move the current document to the path mentioned by the FileX parameter `dest`\nFor `FileX11` this only works for Android 7+ (API 24) due to Android limitations.","cspan":1,"rspan":1,"markup":[1,71,3,6,1,5,3,9,1,68]}],[{"value":"renameTo(newFileName: String)","cspan":1,"rspan":1,"markup":[1,29]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Rename the document in place. This is used to only change the name and cannot move the document.","cspan":1,"rspan":1,"markup":[1,96]}],[{"value":"inputStream()","cspan":1,"rspan":1,"markup":[1,13]},{"value":"InputStream?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns an `InputStream` to the document to write to.","cspan":1,"rspan":1,"markup":[1,11,3,13,1,29]}],[{"value":"outputStream(mode:String=\"w\")","cspan":1,"rspan":1,"markup":[1,29]},{"value":"OutputStream?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns an `OutputStream` to the document to read from.
\nThe `mode` argument is mainly useful for `FileX11`. It can be
`\"r\"` for read-only access,
`\"w\"` for write-only access (erasing whatever data is currently in the file),
`\"wa\"` for write-only access to append to any existing data,
`\"rw\"` for read and write access on any existing data,
and `\"rwt\"` for read and write access that truncates any existing file.
\nFor `FileXT`, pass `\"wa\"` to get a `FileOutputStream` in append mode.","cspan":1,"rspan":1,"markup":[1,11,3,14,1,30,0,4,1,5,3,6,1,31,3,9,1,11,0,4,3,5,1,22,0,4,3,5,1,72,0,4,3,6,1,54,0,4,3,6,1,48,0,4,1,4,3,7,1,60,0,4,1,5,3,8,1,7,3,6,1,10,3,18,1,16]}],[{"value":"list()","cspan":1,"rspan":1,"markup":[1,6]},{"value":"Array-String?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns a String array of all the contents of a directory.","cspan":1,"rspan":1,"markup":[1,58]}],[{"value":"list(filter: FileXFilter)","cspan":1,"rspan":1,"markup":[1,25]},{"value":"Array-String?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns the list filtering with a `FileXFilter`. This is similar to `FileFilter` in Java.","cspan":1,"rspan":1,"markup":[1,34,3,13,1,21,3,12,1,9]}],[{"value":"list(filter: FileXNameFilter)","cspan":1,"rspan":1,"markup":[1,29]},{"value":"Array-String?","cspan":1,"rspan":1,"markup":[1,13]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns the list filtering with a `FileXNameFilter`. This is similar to `FilenameFilter` in Java.","cspan":1,"rspan":1,"markup":[1,34,3,17,1,21,3,16,1,9]}],[{"value":"listFiles()","cspan":1,"rspan":1,"markup":[1,11]},{"value":"Array-FileX?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns an array of FileX pointing to all the contents of a directory.","cspan":1,"rspan":1,"markup":[1,70]}],[{"value":"listFiles(filter: FileXFilter)","cspan":1,"rspan":1,"markup":[1,30]},{"value":"Array-FileX?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns FileX elements array filtering with a `FileXFilter`.","cspan":1,"rspan":1,"markup":[1,46,3,13,1,1]}],[{"value":"listFiles(filter: FileXNameFilter)","cspan":1,"rspan":1,"markup":[1,34]},{"value":"Array-FileX?","cspan":1,"rspan":1,"markup":[1,12]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Returns FileX elements array filtering with a `FileXNameFilter`.","cspan":1,"rspan":1,"markup":[1,46,3,17,1,1]}],[{"value":"copyTo(\n  target:FileX,\n  overwrite:Boolean=false,\n  bufferSize:Int\n)","cspan":1,"rspan":1,"markup":[1,69]},{"value":"FileX","cspan":1,"rspan":1,"markup":[1,5]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Copies a file and returns the target. Logic is completely copied from File.copyTo() of kotlin.io.","cspan":1,"rspan":1,"markup":[1,97]}],[{"value":"copyRecursively(\n  target:FileX,\n  overwrite:Boolean=false,\n  onError:\n    (FileX, Exception)\n)","cspan":1,"rspan":1,"markup":[1,95]},{"value":"Boolean","cspan":1,"rspan":1,"markup":[1,7]},{"value":"-","cspan":1,"rspan":1,"markup":[1,1]},{"value":"Directory copy recursively, return true if success else false.\nLogic is completely copied from File.copyRecursively() of kotlin.io.","cspan":1,"rspan":1,"markup":[1,131]}]]},"theme":null,"fixed_layout":false,"markup":{"instances":[{},{"style":{}},null,{"style":{"color":"#905","backgroundColor":"#ddd"}},null]},"options":{}} \ No newline at end of file