Phonebot developer's reference/Object reference/Using the Phonebot file object - Revision history

Sstrader: Using the Phonebot file object moved to Phonebot developer's reference/Object reference/Using the Phonebot file object

2012-07-29T13:37:23Z

Using the Phonebot file object moved to Phonebot developer's reference/Object reference/Using the Phonebot file object

Sstrader at 11:29, 19 July 2012

2012-07-19T11:29:48Z

Sstrader at 11:29, 19 July 2012

2012-07-19T11:29:17Z

Sstrader at 11:27, 19 July 2012

2012-07-19T11:27:50Z

Sstrader at 03:15, 19 July 2012

2012-07-19T03:15:05Z

Sstrader at 03:13, 19 July 2012

2012-07-19T03:13:27Z

Sstrader at 03:08, 19 July 2012

2012-07-19T03:08:04Z

New page

Properties

{|class="wikitable sortable"
|-
!Syntax
!Access
!Description
|-
|children
|R
|Returns array of file objects. Coerces to false if no children exist.
|-
|cursor_pos
|RW
|The current position of the access cursor
|-
|is_eof
|R
|Boolean
|-
|is_file
|R
|Boolean
|-
|is_folder
|R
|Boolean
|-
|name
|R
|The name of the file or folder
|-
|parent
|R
|The path of the parent file or folder. is_folder will be true. Coerces to false if no parent exists (i.e. this is the root).
|-
|path
|R
|The full path of the file object. May not exist or may not be invalid.
|-
|size
|RW
|The size of the file in bytes
|}

Methods (file management)

{|class="wikitable sortable"
|-
!Syntax
!Description
|-
|boolean = copy_to(path)
|Copy the file or folder to the path. The path must not exist.
|-
|boolean = create_file()
|Create the file. The file must not exist.
|-
|boolean = create_folder()
|Create the folder. The folder must not exist.
|-
|boolean = delete()
|Delete the file or folder.
|-
|boolean = move_to(path)
|Move the file or folder to the path. The path must not exist.
|}

The following table illustrates how the variable value and path parameter value are combined for copy and move calls. The destination will never be deleted. For move calls, the source will be deleted only if it is moved completely.

{|class="wikitable"
|-
!Variable value
!Path parameter
!Description
|-
|/a/x.txt
|/b/y.txt
|y.txt is a copy of x.txt
|-
|/a/x.txt
|/a/y.txt
|A move can be considered a rename in this situation.
|-
|/a
|/b/c
|Any files and folders under "a" will also be created under "c"
|-
|/a
|/b
|A move can be considered a rename in this situation.
|}

Methods (content management)

Data is returned from reads as an array of bytes. Use <code>data:array.byte_to_string()</code> to convert to a string.

Data passed in for searching or writing must be an array of bytes. Use <code>data:string.to_byte_array()</code> to convert from a string, or create the array using decimal values 0-255.

{|class="wikitable sortable"
|-
!Syntax
!Description
|-
|data = read(len)
|Read a len amount of data from the current cursor position
|-
|data = read_line()
|Read from the current cursor position to the next new line. The new line character is not included.
|-
|data = read_to(data)
|Read from the current cursor position to the next section that matches data. The matched data is not included.
|-
|pos = write(data)
|Write a the data at the current cursor position, return the new cursor position.
|-
|pos = write_line(data)
|Write the data at the current cursor position and append a new line, return the new cursor position.
|}

[[Category:Phonebot]]

@@ Line 121: / Line 121: @@
 |}
-* See also [[Phonebot_developer%27s_reference/Object_reference#Module|module.show_file_dialog()]]
+See also [[Phonebot_developer%27s_reference/Object_reference#Module|module.show_file_dialog()]] for navigating the file system from the UI.
 [[Category:Phonebot]]

← Older revision		Revision as of 11:29, 19 July 2012
Line 97:		Line 97:

	Data passed in for searching or writing must be an array of bytes. Use <code>[[Phonebot_developer%27s_reference/Object_reference#String\|string.to_byte_array()]]</code> to convert from a string, or create the array using decimal values 0-255.		Data passed in for searching or writing must be an array of bytes. Use <code>[[Phonebot_developer%27s_reference/Object_reference#String\|string.to_byte_array()]]</code> to convert from a string, or create the array using decimal values 0-255.
		+
		+	Writes at positions less than the file size will overwrite existing data (as opposed to inserting).

	{\|class="wikitable sortable"		{\|class="wikitable sortable"

← Older revision	Revision as of 13:37, 29 July 2012
(No difference)

@@ Line 41: / Line 41: @@
 |size
 |RW
-|The size of the file in bytes
+|The size of the file in bytes. Setting the value resizes the file.
 |}

@@ Line 118: / Line 118: @@
 |Write the data at the current cursor position and append a new line, return the new cursor position.
 |}
 [[Category:Phonebot]]

@@ Line 1: / Line 1: @@
 Properties
@@ Line 95: / Line 94: @@
 Methods (content management)
-Data is returned from reads as an array of bytes. Use <code>data:array.byte_to_string()</code> to convert to a string.
+Data is returned from reads as an array of bytes. Use <code>[[Phonebot_developer%27s_reference/Object_reference#Array|array.byte_to_string()]]</code> to convert to a string.
-Data passed in for searching or writing must be an array of bytes. Use <code>data:string.to_byte_array()</code> to convert from a string, or create the array using decimal values 0-255.
+Data passed in for searching or writing must be an array of bytes. Use <code>[[Phonebot_developer%27s_reference/Object_reference#String|string.to_byte_array()]]</code> to convert from a string, or create the array using decimal values 0-255.
 {|class="wikitable sortable"