File I/O

From Apache OpenOffice Wiki
Jump to: navigation, search Basic has a complete set of statements and runtime functions to access the operating system's file system that are compatible to Visual Basic. For platform independence, the ability to handle file names in file:// URL notation has been added.

It is not recommended to use this classic Basic file interface in the UNO context, because many interfaces in the API expect file I/O specific parameters whose types, for example, are not compatible with the classic Basic file API.

Tip.png The module UCB of Basic library Tools of the container Macros shows some examples of file I/O using the API :
  • Function ReadDirectories( )
  • Sub SaveDataToFile( )
  • Function LoadDataFromFile( )
  • Function CreateFolder( )

For programming, the file I/O in API context with the service should be used. This service supports the interface, including the main interface that provides fundamental methods to access the file system. The methods are explained in detail in the corresponding interface documentation. The following list provides an overview about the operations supported by this service:

  • copy, move and remove files and folders (methods copy(), move(), kill())
  • prompt for information about files and folders (methods isFolder(), isReadOnly(), getSize(), getContentType(), getDateTimeModified(), exists())
  • open or create files (openFileRead(), openFileWrite(), openFileReadWrite()). These functions return objects that support the corresponding stream interfaces, and These interfaces are used to read and write files. The XSimpleFileAccess2 does not have methods of its own for these operations. Additionally, these interfaces are often necessary as parameters to access methods of several other interfaces. The opened files have to be closed by calling the appropriate methods or
  • The XSimpleFileAccess2 also does not have methods to ask for or set the position within a file stream. This is done by calling methods of the interface that is supported by the objects returned by the openXXX() methods.

Two more services are instantiated at the global service manager that extends the service by functionality specific to text files:

Then the method and are used to read text from the input stream/file. The method is used to check for if the end of the file is reached. The sets a text encoding where UTF-8 is the default.

Then the method is used to write text to the output stream.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages