request_string, request_tuple
| Format: request_string ( url, options ) |
| Format: request_tuple ( url, options ) |
Purpose: Both functions provide access to the curl library (http://curl.haxx.se/) for retriving docments from the web using http and ftp requests. Both functions perform the same operation but request_tuple returns additional information.
Both functions are available only if secure mode is off and if the requestcurl module has been compiled or linked into heitml.
Return Values: When successful, request_string() returns a string containing the document obtained. request_string() in turn returns a tuple with various fields containing information about the request performed. The field "..." contains the document obtained,
Options Argument:
Both functions have an additional argument options. It must be a tuple containing various options for curl. The following options are supported and are documented in the curl web site or the curl manual page ("man curl_easy_setopt"): Proxy, ProxyPort, httpproxytunnel, ProxyType, Interface, LocalPort, LocalPortRange, dns_cache_timeout, dns_use_global_cache, buffersize, port, tcp_nodelay, netrc, netrc_file, userpwd, proxyuserpwd, httpauth, proxyauth, AutoReferer, Encoding, FollowLocation, unrestricted_auth, maxredirs, put, post, postfields, postfieldsize, httppost (post data as tuple), Referer, UserAgent, header (headers as tuple), cookie, cookieSession, cookielist, get, http_version, ignore_content_length, ftpport, FtpListOnly, FtpAppend, ftp_use_eprt, ftp_use_epsv, ftp_create_missing_firs, ftp_response_timeout, ftp_alternative_to_user, ftp_skip_pasv_ip, ftp_ssl, ftp_sslauth, source_url, source_userpwd, ftp_account, ftp_filemethod, TransferText, crlf, range, resume_from, customRequest, filetime, nobody, inFileSize, upload, maxFileSize, timecondition, timevalue, timeout, low_speed_limit, low_speed_time, maxConnects, closepolicy, fresh_connect, forbid_reuse, connectTimeOut, ipresolve, sslCert, sslCertType, sslCertPasswd, sslKey, sslKeyType, sslKeyPasswd, sslKeyType, sslKeyPasswd, sslEngine, sslEngine_default, sslversion, ssl_verifyPeer, caInfo, caPath, random_file, egdSocket, verifyHost, ssl_cipher_list.
Example:
<let
s= request_string ("http://www.radpage.com/");
// s now contains the complete homepage of radpage.com
// extract the title using a regular expression and print it
? substRE (s,"(?is:^.*TITLE>(.*)</TITLE.*$)","$1") "H";
>
|
| resulting output: |
Component based Web Development Tool - RADpage |
Example:
<let
t= request_tuple ("http://www.h-e-i.de/");
? t;
>
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| resulting output: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Example:
<let
opts=emptytuple; opts.followlocation=false; // prevent following redirects
t= request_tuple ("http://www.radpage.com/heitml2.1", opts);
? t;
? t.content "H";
>
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| resulting output: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
© 1996-2023 H.E.I. All Rights Reserved.
