libURLErrorData

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
libURLErrorData(<url>)
Associationsinternet library
Summary

Returns any error that was caused during a download that was started with the load command.

Introduced1.1.1
OSmac, windows, linux, web
Platformsdesktop, server
Parameters
NameTypeDescription
url

A URL, or an expression that evaluates to a URL.

Example
put libURLErrorData("http://www.example.org/index.html") into myErr
if libURLErrorData(it) contains "404" then answer "File doesn't exist!"
if libURLStatus(myURL) is "error" then return libURLErrorData(myURL)
Values
NameTypeDescription
return

The libURLErrorData function returns a string.

The result

You can check the URLStatus function to determine the status of a URL that has been cached with the load command. If the download encountered an error, the URLStatus function returns "error". In this case, the libURLErrorData function returns the result of the attempted download.

RelatedKeyword: https, ftp, URL, http
Glossary: LiveCode custom library, return, Standalone Application Settings, download, cache, standalone application, command, server
Command: libURLSetLogField, load
Function: libURLErrorData, cachedURLs, URLStatus
Library: Internet library
Control Structure: function
Securitynetwork
Description

Use the libURLErrorData function to check the error status of a download.

If the download failed because of a server error--for example, if a requested web page was not found--the libURLErrorData function returns the error message sent by the server. If the download failed for another reason--for example, if the server did not respond, or if an invalid URL was supplied--the libURLErrorData function returns an error message generated by the Internet library.

Important: The libURLErrorData function is part of the Internet library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Internet" script library is selected.

Tagsnetworking