Object 內置對象

對象RangeStream

Range 查詢流讀取對象

RangeStream 對像用於對 SeekableStream對像數據進行截取。創建方法:

1 2 3 4 5
var stm = new io.RangeStream(stream, '0-10'); stm.end // 11 var stm = new io.RangeStream(stream, 0, 10); stm.end // 10

繼承關係

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>Stream|fd|read();write();flush();close();copyTo()] [<class>SeekableStream|seek();tell();rewind();size();readAll();truncate();eof();stat()] [<this>RangeStream|new RangeStream()|begin;end] [object] <:- [Stream] [Stream] <:- [SeekableStream] [SeekableStream] <:- [RangeStream] Stream fd read() write() flush() close() copyTo() RangeStream new RangeStream() begin end object toString() toJSON() SeekableStream seek() tell() rewind() size() readAll() truncate() eof() stat()

構造函數

RangeStream

RangeStream 構造函數

1 2
new RangeStream(SeekableStream stm, String range);

調用參數:

  • stm: SeekableStream, RangeStream 的二進制基礎流對象, 必須是 SeekableStream
  • range: String, 描述range 的字符串, 格式為'begin-[end]', '[begin]-end'

RangeStream 構造函數

1 2 3
new RangeStream(SeekableStream stm, Long begin, Long end);

調用參數:

  • stm: SeekableStream, RangeStream 的二進制基礎流對象, 必須是 SeekableStream
  • begin: Long, 從stm 讀取內容的起始位置
  • end: Long, 從stm 讀取內容的結束位置

成員屬性

begin

Long, 查詢range 開始值

1
readonly Long RangeStream.begin;

end

Long, 查詢range 結束值

1
readonly Long RangeStream.end;

fd

Integer, 查詢 Stream 對應的文件描述符值, 由子類實現

1
readonly Integer RangeStream.fd;

成員函數

seek

移動文件當前操作位置

1 2
RangeStream.seek(Long offset, Integer whence = fs.SEEK_SET);

調用參數:

  • offset: Long, 指定新的位置
  • whence: Integer, 指定位置基準,允許的值為:SEEK_SET, SEEK_CUR, SEEK_END

tell

查詢流當前位置

1
Long RangeStream.tell();

返回結果:

  • Long, 返回流當前位置

rewind

移動當前位置到流開頭

1
RangeStream.rewind();

size

查詢流尺寸

1
Long RangeStream.size();

返回結果:

  • Long, 返回流尺寸

readAll

從流內讀取剩餘的全部數據

1
Buffer RangeStream.readAll() async;

返回結果:

  • Buffer, 返回從流內讀取的數據,若無數據可讀,或者連接中斷,則返回null

truncate

修改文件尺寸,如果新尺寸小於原尺寸,則文件被截斷

1
RangeStream.truncate(Long bytes) async;

調用參數:

  • bytes: Long, 新的文件尺寸

eof

查詢文件是否到結尾

1
Boolean RangeStream.eof();

返回結果:

  • Boolean, 返回True 表示結尾

stat

查詢當前文件的基礎信息

1
Stat RangeStream.stat() async;

返回結果:

  • Stat, 返回 Stat 對象描述文件信息

read

從流內讀取指定大小的數據

1
Buffer RangeStream.read(Integer bytes = -1) async;

調用參數:

  • bytes: Integer, 指定要讀取的數據量,缺省為讀取隨機大小的數據塊,讀出的數據尺寸取決於設備

返回結果:

  • Buffer, 返回從流內讀取的數據,若無數據可讀,或者連接中斷,則返回null

write

將給定的數據寫入流

1
RangeStream.write(Buffer data) async;

調用參數:

  • data: Buffer, 給定要寫入的數據

flush

將文件緩衝區內容寫入物理設備

1
RangeStream.flush() async;

close

關閉當前流對象

1
RangeStream.close() async;

copyTo

複製流數據到目標流中

1 2
Long RangeStream.copyTo(Stream stm, Long bytes = -1) async;

調用參數:

  • stm: Stream, 目標流對象
  • bytes: Long, 複製的字節數

返回結果:

  • Long, 返回複製的字節數

toString

返回對象的字符串表示,一般返回"[Native Object]",對象可以根據自己的特性重新實現

1
String RangeStream.toString();

返回結果:

  • String, 返回對象的字符串表示

toJSON

返回對象的JSON 格式表示,一般返回對象定義的可讀屬性集合

1
Value RangeStream.toJSON(String key = "");

調用參數:

  • key: String, 未使用

返回結果:

  • Value, 返回包含可JSON 序列化的值