IOException

From Xojo Documentation

Revision as of 17:34, 10 December 2019 by PLefebvre (talk | contribs) (macOS)
You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!

Class (inherits from RuntimeException)

Raised when an IO error occurs using BinaryStream, TextOutputStream, or TextInputStream.

Properties
ErrorNumber Message
Methods
Stack StackFrames

Notes

The IOException represents errors that can occur while using the shared methods for opening and creating streams: BinaryStream.Open, BinaryStream.Create, TextOutputStream.Create, TextOutputStream.Append, and TextInputStream.Open. If you are using older APIs, you need to check the FolderItem.LastErrorCode property.

Error Codes

The ErrorNumber property of an IOException may be set to an OS error code.

macOS

The OS Status web site can help track down error code meanings.

In addition you can check the older Mac OS System Error Codes, which are can still be useful since LastErrorCode uses older Carbon error codes.

Windows

Windows error codes are available at MSDN.

Linux

Linux error codes are defined in a header file, errno.h.

Sample Code

The following example catches an IOException if it occurs.

Var f As FolderItem = FolderItem.ShowSaveFileDialog(FileTypes1.Text, "Create Example.txt")
If f <> Nil Then
Var t As TextOutputStream = TextOutputStream.Create(f) // this line could raise an IOException.
t.WriteLine(TextField1.Value)
End If

Exception err As IOException
MsgBox("an IO exception occurred")

See Also

BinaryStream, RuntimeException, TextInputStream, TextOutputStream classes.