4D v14.3

Open document

Home

 
4D v14.3
Open document

Open document 


 

Open document ( document {; fileType}{; mode} ) -> Function result 
Parameter Type   Description
document  String in Document name or Full document pathname or Empty string for standard file dialog box
fileType  String in List of types of documents to be screened, or "*" to not screen the documents
mode  Longint in Document’s opening mode
Function result  DocRef in Document reference number

The Open document command opens the document whose name or pathname you pass in document.

If you pass an empty string in document, the Open File dialog box is presented, and you then select the document to be open. If you cancel the dialog, no document is opened; Open document returns a null DocRef and sets the OK variable to 0.

  • If the document is correctly opened, Open document returns its document reference number and sets the OK variable to 1.
  • If the document is already open in Read mode and the mode parameter is omitted, Open document opens the document in Read/Write mode by default and sets the OK variable to 1.
  • If the document is already open in Read/Write mode and you try to open it in Write mode, an error (-43) is generated. However, you can open it in Read only mode, then the OK variable is set to 1.
  • If the document does not exist, an error is generated.

In the fileType parameter, pass the type(s) of file(s) that can be selected in the opening dialog box. You can pass a list of several types separated by a ; (semi-colon). For each type set, an item will be added to the menu used for choosing the type in the dialog box.

Under Mac OS, you can pass either a standard Mac OS type (TEXT, APPL, etc.), or a UTI (Uniform Type Identifier) type. UTIs are defined by Apple in order to meet standardization needs for file types. For example, "public.text" is the UTI type of text type files. For more information about UTIs, refer to the following address:
https://developer.apple.com/library/mac/#documentation/FileManagement/Conceptual/
understanding_utis/understand_utis_intro/understand_utis_intro.html
.

Under Windows, you can also pass a standard Mac OS file type — 4D makes the correspondence internally — or file extensions (.txt, .exe, etc.). Note that under Windows, the user can “force” the display of all file types by entering *.* in the dialog box. However, in this case, 4D will carry out an additional check of the selected file types: if the user selects an unauthorized file type, the command returns an error.

If you do not want to restrict the displayed files to one or more types, pass the "*" (star) string or ".*" in fileType.

The optional mode parameter allows you to define how document is to be opened. Four different open file modes are possible. 4D offers the following predefined constants, located in the "System Documents" theme:

Constant Type Value
Get Pathname Longint 3
Read and Write Longint 0
Read Mode Longint 2
Write Mode Longint 1

If a document is open, Open document initially sets the file position at the beginning of the document while Append document sets it at the end of the document.

Once you have opened a document, you can read and write in the document using the RECEIVE PACKET and SEND PACKET commands that you can combine with the Get document position and SET DOCUMENT POSITION commands in order to directly access any part of the document.

Do not forget to eventually call CLOSE DOCUMENT for the document.

The following example opens an existing document called Note, writes the string “Good-bye” into it, and closes the document. If the document already contains the string “Hello”, this string would be overwritten:

 C_TIME(vhDoc)
 vhDoc:=Open document("Note.txt";Read and Write` Open a document called Note
 If(OK=1)
    SEND PACKET(vhDoc;"Good-bye") ` Write one word into the document
    CLOSE DOCUMENT(vhDoc) ` Close the document
 End if

You can read a document even if it is already open in write mode:

 vDoc:=Open document("PassFile";"TEXT") ` The file is open
  ` Before the file is closed, it is possible to consult it in read-only mode:
 vRef:=Open document("PassFile";"TEXT";Read Mode)

If the document is correctly opened, the OK system variable is set to 1; otherwise, it is set to 0. After the call, the Document system variable contains the full name of the document.
If you call Open document with a mode of 3, the function returns ?00:00:00? (no document reference). The document is not opened but the Document and OK system variables are updated:

  • OK is equal to 1.
  • Document contains the full pathname and the name of document.

Note: If you pass an empty string in document, an open file dialog box appears. If the user chooses a document and clicks the OK button, document is set to the path of the document the user selected and OK is set to 1. If the user clicked the Cancel button, OK is set to 0.

 
PROPERTIES 

Product: 4D
Theme: System Documents
Number: 264

The OK variable is changed by the commandThis command modifies the system Document variableThis command modifies the Error system variable

 
HISTORY 

Modified: 4D v11 SQL

 
SEE ALSO 

Append document
Create document

 
ARTICLE USAGE

4D Language Reference ( 4D v11 SQL Release 6)
4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)