A newer version of Max is available. Click here to access the latest version of the documentation

jit.textfile Reference

Read and write a matrix as an ASCII text file



The jit.textfile object maintains a text buffer, into which a text file or char matrix can be imported. The buffer can also be edited directly by double-clicking on the object to open an editor window. A bang to the object causes the text buffer to be sent out the left outlet as a matrix.



In adapt mode, jit.textfile will analyze the file for carriage returns and deduce the probable width and height of the output matrix (always 1 plane 2 dimensional). String matrices can be output using the line message.

Matrix Operator

matrix inputs:1, matrix outputs:2
Name IOProc Planelink Typelink Dimlink Plane Dim Type
out n/a 1 1 1 1 1 char
out2 n/a 1 1 1 1 1 char

More about Matrix Operators

The Jitter MOP

MOP Arguments

MOP Attributes

MOP Messages


autoclear [int]

Matrix clear following output flag (default = 1)

defaultdir [symbol]

The default directory for writing files (default = default path)

convert [int]

Convert line breaks flag (default = 1) When the flag is set, UNIX/DOS line breaks are converted to Macintosh format when reading a file from disk.

title [symbol]

Sets the title for the text editor window

Common Box Attributes



Double-clicking on the object opens a text editor window with the current contents of the text buffer.


Clear the object's text buffer.



line-number [int]
Sends the line specified by the argument out the middle outlet of the object as a string matrix (1 dimensional char matrix, 0 terminated) that can be used by the jit.str. set of objects. Line numbering starts at 1.


Opens the text editor window. Sending this message is equivalent to double-clicking on the object.


Sends the matrix out the middle outlet. This is equivalent to the outputmatrix message, but uses to the middle outlet rather than the left outlet. (For this object, the outputmatrix message refers only to the left outlet).



filename [symbol]
Reads a text file from disk if a filename is specified. Otherwise, an file dialog box will appear so that a text file can be specified.


Closes the editor window, if open.



filename [symbol]
Writes the object's text buffer to a disk file. The optional argument specifies a file name.

See Also

Name Description
Tutorial 20: Importing and Exporting Single Matrices Tutorial 20: Importing and Exporting Single Matrices