sysError

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
the sysError
sysError()
Summary

Returns the operating system's error status.

Introduced1.0
OSmac, windows, linux
Platformsdesktop, server
Example
the sysError
if the sysError is zero then answer "Success!"
Values
NameTypeDescription
return

The sysError function returns an integer.

The result

Most operating system requests have to do with actions on files. For example, when you open a file or copy a resource, LiveCode requests the operating system to complete the action. If the action fails, the result is set to an error message, and the sysError function contains the error message the operating system reported to LiveCode. *Note:* When using the sysError function to check whether a command succeeded, be sure to check the result first. The sysError reports the operating system's error report, and some operating-system commands may report a value (and therefore set the sysError) even if the command succeeded. Only if the result is not empty does the sysError indicate that the command failed.

RelatedKeyword: integer
Command: close file, kill
Function: result, sysError, value
Control Structure: function
Glossary: error message, command, return, variable
Description

Use the sysError function to obtain the reason a command that makes an operating-system request failed.

On Unix systems, the sysError function returns the value of the "errno" variable.

On Windows systems, the sysError function returns the value returned by the "GetLastError()" function.