Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
m
Text replacement - "\[\[#(file:[^|]+)\|(file:[^|]+)\]\]" to "{{Function|File|$1}}"
! Description
|- valign="top"
| [[#file:descendants{{Function|File|file:descendants]]}}
| new function
|- valign="top"
| [[#file:is-absolute{{Function|File|file:is-absolute]]}}
| new function
|- valign="top"
| [[#file:read-text{{Function|File|file:read-text]]}}, [[#file:read-text-lines{{Function|File|file:read-text-lines]]}}
| <code>$fallback</code> argument added
|- valign="top"
| [[#file:read-text-lines{{Function|File|file:read-text-lines]]}}
| <code>$offset</code> and <code>$length</code> arguments added
|- valign="top"
| [[#file:resolve-path{{Function|File|file:resolve-path]]}}
| <code>$base</code> argument added
|}
|-
| '''Summary'''
|Returns the full paths to all files and directories found in the specified {{Code|$dir}}.<br/>The inverse function is [[#file:parent{{Function|File|file:parent]]}}. The related function [[#file:list{{Function|File|file:list]] }} returns relative file paths.
|-
| '''Errors'''
|-
| '''Summary'''
|Returns the full paths to all files and directories found in the specified {{Code|$dir}} and its sub-directories.<br/>. The related function [[#file:list{{Function|File|file:list]] }} returns relative file paths.
|-
| '''Errors'''
|-
| '''Summary'''
|Returns the absolute path to the parent directory of a file or directory specified by {{Code|$path}}. An empty sequence is returned if the path points to a root directory.<br/>The inverse function is [[#file:children{{Function|File|file:children]]}}.<br />
|-
| '''Examples'''
;Version 9.3
* Added: [[#file:descendants{{Function|File|file:descendants]]}}
;Version 9.0
* Updated: [[#file:read-text-lines{{Function|File|file:read-text-lines]]}}: <code>$offset</code> and <code>$length</code> arguments added.
;Version 8.5
* Updated: [[#file:read-text{{Function|File|file:read-text]]}}, [[#file:read-text-lines{{Function|File|file:read-text-lines]]}}: <code>$fallback</code> argument added.
;Version 8.2
* Added: [[#file:is-absolute{{Function|File|file:is-absolute]]}}* Updated: [[#file:resolve-path{{Function|File|file:resolve-path]]}}: base argument added
;Version 8.0
* Added: [[#file:current-dir{{Function|File|file:current-dir]]}}, [[#file:base-dir{{Function|File|file:base-dir]]}}, [[#file:children{{Function|File|file:children]]}}
;Version 7.8
* Added: [[#file:parent{{Function|File|file:parent]]}}, [[#file:name{{Function|File|file:name]]}}* Updated: error codes; [[#file:read-binary{{Function|File|file:read-binary]]}}, [[#file:write-binary{{Function|File|file:write-binary]]}}: {{Code|$offset}} and {{Code|$length}} arguments added.
* Deleted: file:base-name, file:dir-name
;Version 7.7
* Added: [[#file:create-temp-dir{{Function|File|file:create-temp-dir]]}}, [[#file:create-temp-file{{Function|File|file:create-temp-file]]}}, [[#file:temp-dir{{Function|File|file:temp-dir]]}}
* Updated: all returned strings that refer to existing directories will be suffixed with a directory separator.
;Version 7.3
* Added: [[#file:append-text{{Function|File|file:append-text]]}}, [[#file:write-text{{Function|File|file:write-text]]}}, [[#file:append-text-lines{{Function|File|file:append-text-lines]]}}, [[#file:write-text-lines{{Function|File|file:write-text-lines]]}}, [[#file:line-separator{{Function|File|file:line-separator]]}}* Aligned with latest specification: $file:directory-separator → [[#file:dir-separator{{Function|File|file:dir-separator]]}}, $file:path-separator → [[#file:path-separator{{Function|File|file:path-separator]]}}, file:is-directory → [[#file:is-dir{{Function|File|file:is-dir]]}}, file:create-directory → [[#file:create-dir{{Function|File|file:create-dir]]}}* Updated: [[#file:write-binary{{Function|File|file:write-binary]]}}, [[#file:append-binary{{Function|File|file:append-binary]]}}: output limited to a single value
;Version 7.2.1
* Updated: [[#file:delete{{Function|File|file:delete]]}}: {{Code|$recursive}} parameter added to prevent sub-directories from being accidentally deleted.* Fixed: [[#file:list{{Function|File|file:list]] }} now returns relative instead of absolute paths.
