Prev: Simplified Syntax for Interactive Use

Shell Builtin Functions

autoexec.m declares a number of function for interactive use. Most are just wrappers around existing functions, to avoid typing longer names. With these functions, files on the phone can be easily manipulated:

// list all JPG files on the current drive dir \*.jpg/r/l → -- 05-08-09  2966 \documents\mShell\GraphTest.jpg -- 11:37:02 17909 \Nokia\Images\FE_img\FEscr(0).jpg ... // copy the JPG files in \documents\mShell to drive e: cp \documents\mShell\*.jpg e: → 1 // search for the mShell properties file dir \*.prp/r → \System\Apps\mShell\mShell.prp // show its contents type \system\apps\mShell\mShell.prp → mfont=LatinPlain12 outsize=20000 keep=busy

If a customized autoexec.m in system.docdir is created without incorporating the original script, these function are no longer available.

• .cp
• .del
• .dir
• .edit
• .exit
• .md
• .mv
• .rd
• .ren
• .run
• .send
• .type

.cp

• function cp(src, dst, recursive=false) → Number
    /r:recursive

Copies a file, files matching a pattern, or an entire directory tree. Wrapper for files.copy.

.del

• function del(pattern, recursive=false) → Number
    /r:recursive

Deletes a file, files matching a pattern, also in complete directory tree. Wrapper for files.delete.

.dir

• function dir(pattern="*", recursive=false, long=false, hidden=false, modified=0) → null
    /h:hidden
    /l:long
    /m:modified
    /r:recursive

List files matching pattern on standard output. If pattern is a directory, lists all files in it. Options are the following:

• With /h (hidden=true), also lists hidden files and directories.
• With /l (long=true), lists files and directories in a long format, including readonly and hidden attributes and modification date (format YY-MM-DD or hh:mm:ss).
• With /m=secs (modified=secs), lists only files which were modified within the last secs seconds.

.edit

• function edit(name) → null

Loads a file into the builtin editor and shows it. Wrapper for files.edit.

.exit

• function exit() → null

Exit this shell. This is equivalent to closing it. This function is only available if module proc is available.

.md

• function md(path, all=false) → Number
    /a:all

Creates a directory or directories. Wrapper for files.mkdir.

.mv

• function mv(src, dst, recursive=false) → Number
    /r:recursive

Moves a file, files matching a pattern, or an entire directory tree. Wrapper for files.move.

.rd

• function rd(path, recursive=false) → Number
    /r:recursive

Removes a directory or an entire directory tree. Wrapper for files.rmdir.

.ren

• function ren(old, new) → Number

Renames a single file. Wrapper for files.rename.

.run

• function run(script, show=false) → null
    /s:show

Run another m script. If show=true, the script's console is shown. This function is only available if module proc is available.

.send

• function send(name, subject=null) → null

Interactively sends a file over a channel chosen by the user. Wrapper for files.send.

.type

• function type(file, utf16=false, tail=false) → null
    /u:utf16
    /t:tail

Writes the contents of file to standard output.

If utf16=true, assumes the file to be UTF-16 little endian encoded. Otherwise, raw encoding is assumed.

If tail=true, only outputs the last 300 bytes. If tail=n where n is a number, outputs the last n bytes.

---

Next: Producing Standalone Applications

Navigation