inet.url 库模块帮助文档

inet.url 成员列表

inet.url.append

拼接URL

inet.url.append(url目录,url子路径,...)

支持不定个数参数。
第一个参数无论是否以"/"字符结束都认为是一个目录。

inet.url.appendExtraInfo(url,附加参数)

在 URL 后追加参数。
参数首字符不能是问号。
参数@2也可以指定一个包含多个参数键值对的表。

如果 @url 参数仅指定路径而非合法 URL，
则简单添加 ? 号后拼接参数

inet.url.canonicalize("当前URL",_URL)

URL规范化转换
参数@3指定转换选项

inet.url.canonicalize(URL)

URL规范化转换
扩展和适当置换路径中包含的所有 .. 和 .

inet.url.cmp()

比较参数@1与参数@2指定的网址是否相同。
相同则返回 0 ，否则返回其他数值。
比较前进行 URL 解码，并调用 inet.url.canonicalize 规范格式，
比较时忽略大小写

inet.url.decode(字符串,输入代码页)

URL解码并返回文本,失败返回空值,
参数二指定输入编码(codepage),省略自动检测输入编码
此函数返回数据转换为UTF8编码

inet.url.decodeUnicode(字符串)

解码%uXXXX或%uXX编码的字符串
失败返回空值

inet.url.encode(字符串,输出代码页)

除字母数字以及-._~等非保留字符以外的字符进行URL编码,
参数二指定输出编码(codepage),默认为65001(UTF8代码页)

inet.url.encodeMbcs(字符串,输出代码页)

如果字符串包含多字节字符,
使用URL编码其中的汉字和%符号,
参数二指定输出编码(codepage),默认为65001(UTF8代码页)

inet.url.encodeUri(字符串,输出代码页)

URL编码,
字母数字以及 URL 非保留字符、URL 保留字符都不编码（RFC3986）,
参数二指定输出编码(codepage),默认为65001(UTF8代码页)

inet.url.getFileName(网址,默认文件名)

获取URL中的文件名
参数2可选,默认为"index.html"

inet.url.getFilePath()

如果 URL 为 file: 协议开头，
则返回 URL 解码后的文件路径，否则返回 null。
传入 null 参数返回 null。

inet.url.getParams()

返回 URL 的参数表，参数名都转为小写。
参数 @1 指定 URL，如果不指定则直接返回 null 。
如果参数 @1 指定了参数名（忽略大小写），则返回对应的字符串值

inet.url.hashNum(url)

返回哈希数值

inet.url.is(url,_URLIS)

检测URL

inet.url.joinpath

当对于当前URL的相对路径转换为完整 URL 。
注意该函数忽略文件名,简单拼接请使用 append 函数替代

inet.url.joinpath("当前URL",相对路径,_URL)

当对于当前 URL 的相对路径转换为完整 URL 。
相对路径如果为空则直接返回参数 @1,
可选使用参数三指定转换选项

inet.url.split()

返回对象:inetUrlcrackObject

inet.url.split(输入URL)

拆分URL返回包含协议、路径、端口、参数等的表对象
返回的表对象可以调用 tostring 重新生成 URL
可传入空值以获取用于拼接URL的表

inet.url.splitParameters

拆分URL参数并返回名值对组成的表对象
名字都转换为小写,如果名字尾部有[]或[键名]则值转换为表
如果只指定名字不指定值,则值为空字符串

inet.url.splitParameters(URL参数,分隔符,输入UTF8编码,数组键名)

拆分URL参数并返回表对象。
分隔符支持模式语法,默认为'&'。
如果不指定分隔符,并且首字符是?号，此函数自动移除首字符。
使用 URL 解码键值文本,参数 @3 指定解码前是否UTF8编码，不指定则自动检测。
参数 @4 可选指定一个总是返回数组值的参数名称数组，参数名尾部如果有点号加数值则自动移除。

inet.url.stringify(urlInfo)

inet.url.stringify(  
    scheme = "https";  
    user = "";  
    password ="";  
    host ="/*使用参数表构建并返回URL字符串*/";  
    location = "";  
    extraInfo = {  
        name = value;  
    };  
)

inet.url.stringifyParameters

将URL参数表转换为字符串

inet.url.stringifyParameters(参数表,输出代码页,排序函数)

使用'='分隔键值对,使用'&'分隔不同参数,
如果值为表,则转换为多个键值对,键名后添加[]或[子键名]。
如果值为函数则调用该函数取返回值。
所有值转换为字符串并使用 UrlEncode 编码。
参数@2指定输出编码（codepage）,默认为65001（UTF8代码页)
省略排序函数则使用默认字典序排序

inetUrlcrackObject 成员列表

inetUrlcrackObject.extraInfo

附加参数
如果有URL参数,这里首字符会是?号
不包含#号后面的网页位置

inetUrlcrackObject.host

域名

inetUrlcrackObject.location

URL中#号后面的网页位置,不包含#号

inetUrlcrackObject.password

密码

inetUrlcrackObject.path

文件路径;

inetUrlcrackObject.port

端口

inetUrlcrackObject.scheme

协议，总是转换为小写

inetUrlcrackObject.schemeNum

协议（数值）。
可用值为 INTERNET_SCHEME 前缀的常量定义。
重新拼接 URL 时忽略此参数

inetUrlcrackObject.user

用户名

自动完成常量

_INTERNET_SCHEME_DEFAULT=0x0
_INTERNET_SCHEME_FILE=5
_INTERNET_SCHEME_FIRST=1
_INTERNET_SCHEME_FTP=1
_INTERNET_SCHEME_GOPHER=2
_INTERNET_SCHEME_HTTP=3
_INTERNET_SCHEME_HTTPS=4
_INTERNET_SCHEME_JAVASCRIPT=9
_INTERNET_SCHEME_LAST=0xB
_INTERNET_SCHEME_MAILTO=7
_INTERNET_SCHEME_NEWS=6
_INTERNET_SCHEME_PARTIAL=0xFFFFFFFE
_INTERNET_SCHEME_RES=0xB
_INTERNET_SCHEME_SOCKS=8
_INTERNET_SCHEME_UNKNOWN=0xFFFFFFFF
_INTERNET_SCHEME_VBSCRIPT=0xA
_URLIS_URL=0x0
_URL_APPLY_DEFAULT=1
_URL_APPLY_FORCEAPPLY=8
_URL_APPLY_GUESSFILE=4
_URL_APPLY_GUESSSCHEME=2
_URL_BROWSER_MODE=0x2000000
_URL_CONVERT_IF_DOSPATH=0x200000
_URL_DONT_ESCAPE_EXTRA_INFO=0x2000000
_URL_DONT_SIMPLIFY=0x8000000
_URL_DONT_UNESCAPE=0x20000
_URL_DONT_UNESCAPE_EXTRA_INFO=0x2000000
_URL_ESCAPE_AS_UTF8=0x40000
_URL_ESCAPE_PERCENT=0x1000
_URL_ESCAPE_SEGMENT_ONLY=0x2000
_URL_ESCAPE_SPACES_ONLY=0x4000000
_URL_ESCAPE_UNSAFE=0x20000000
_URL_FILE_USE_PATHURL=0x10000
_URL_INTERNAL_PATH=0x800000
_URL_NO_META=0x8000000
_URL_PARTFLAG_KEEPSCHEME=1
_URL_PLUGGABLE_PROTOCOL=0x40000000
_URL_UNESCAPE=0x10000000
_URL_UNESCAPE_HIGH_ANSI_ONLY=0x400000
_URL_WININET_COMPATIBILITY=0x80000000

Markdown 格式