组件：因特网
===================
此组件由[[item:internet_card:zh|因特网卡]]提供。

组件名：`internet`。  

回调函数：

- `isTcpEnabled():boolean`  
  返回是否可建立TCP连接（可在配置文件中设置）。  
  \\
- `isHttpEnabled():boolean`  
  返回是否可进行HTTP请求（可在配置文件中设置）。  
  \\
- `connect(address:string[, port:number]):userdata`  
  建立一个新的TCP连接。返回连接的句柄。  
  \\
- `request(url:string[, postData:string[, headers:table]]):userdata`  
  发送一个新的HTTP请求。返回连接的句柄。

====TCP套接字对象====

- `read([n:number]):string`  
  尝试从套接字流中读取数据。返回读取到的字节数组。  
  \\
- `close()`  
  关闭某个已打开的套接字流。  
  \\
- `write(data:string):number`  
  尝试向套接字流中写入数据。返回写入的字节数。  
  \\
- `finishConnect():boolean`  
  确认套接字已连接。若连接失败会报错。  
  \\
- `id():string`  
  返回此套接字的ID。

在调用`finishConnect`或者`read`后，套接字会在有新数据可供读取时产生一个名为`internet_ready`的信号。此信号有一个参数，代表套接字ID。
====HTTP请求对象====

- `read([n:number]):string`  
  尝试从响应中读取数据。返回读取到的字节数组。  
  \\
- `response():number, string, table`  
  获取响应码、响应信息与响应头。  
  \\
- `close()`  
  关闭某个已打开的套接字流。  
  \\
- `finishConnect():boolean`  
  确认套接字已连接。若连接失败会报错。

目录
----

{{page>component:contents:zh&noheader&noeditbutton&nouser&nofooter}}