目錄

名稱

Net::FTP::dataconn - FTP Client 資料連線類別

語法

# Perform IO operations on an FTP client data connection object:

$num_bytes_read = $obj->read($buffer, $size);
$num_bytes_read = $obj->read($buffer, $size, $timeout);

$num_bytes_written = $obj->write($buffer, $size);
$num_bytes_written = $obj->write($buffer, $size, $timeout);

$num_bytes_read_so_far = $obj->bytes_read();

$obj->abort();

$closed_successfully = $obj->close();

說明

Net::FTP 中定義的一些方法會傳回一個物件,該物件會從這個類別衍生而來。dataconn 類別本身從 IO::Socket::INET 類別衍生而來,因此可以執行任何正常的 IO 作業。不過,下列方法是在 dataconn 類別中定義的,而 IO 應該使用這些方法來執行。

read($buffer, $size[, $timeout])

從伺服器讀取 $size 位元組的資料並將其放入 $buffer 中,同時執行任何必要的 <CRLF> 轉換。$timeout 是選用的,如果未提供,將使用命令連線中的逾時值。

傳回在任何 <CRLF> 轉換之前讀取的位元組數。

write($buffer, $size[, $timeout])

$size 位元組的資料從 $buffer 寫入伺服器,同時執行任何必要的 <CRLF> 轉換。$timeout 是選用的,如果未提供,將使用命令連線中的逾時值。

傳回在任何 <CRLF> 轉換之前寫入的位元組數。

bytes_read()

傳回迄今為止讀取的位元組數。

abort()

中止目前的資料傳輸。

close()

關閉資料連線並從 FTP 伺服器取得回應。如果連線成功關閉,且伺服器回應的第一個數字為「2」,則傳回 true

EXPORTS

.

已知錯誤

.

作者

Graham Barr <gbarr@pobox.com>。

Steve Hay <shay@cpan.org> 目前維護 libnet,版本為 1.22_02。

版權

版權所有 (C) 1997-2010 Graham Barr。保留所有權利。

版權所有 (C) 2013-2014, 2020 Steve Hay。保留所有權利。

授權

此模組為自由軟體;您可以在與 Perl 相同的條款下重新散布或修改它,即 GNU 通用公共授權或 Artistic 授權的條款,如 LICENCE 檔案中所述。

版本

版本 3.15

日期

2023 年 3 月 20 日

歷史

請參閱 Changes 檔案。