# fsys.stream 库模块帮助文档 ## fsys 成员列表 # ### fsys.stream # 文件流对象兼容IStream,ISequentialStream接口创建文件流对象,返回对象可传入其他线程使用。 ### fsys.stream("文件路径","a") # 只写追加模式打开文件流,创建新文件保留原文件 ### fsys.stream("文件路径","a+") # 读写追加模式打开文件流,创建新文件保留原文件注意流对象总是以二进制模式读写，不需要添加b标记 ### fsys.stream("文件路径","r+") # 读写模式打开文件流,文件必须存在注意流对象总是以二进制模式读写，不需要添加b标记 ### fsys.stream("文件路径","w") # 只写模式打开文件流,创建新文件清空原文件注意流对象总是以二进制模式读写，不需要添加b标记 ### fsys.stream("文件路径","w+") # 读写模式打开文件流,创建新文件清空原文件注意流对象总是以二进制模式读写，不需要添加b标记 ### fsys.stream() # [返回对象:fsysStreamObject](#fsysStreamObject) ### fsys.stream(IStream接口指针) # 直接使用指针创建对象 ### fsys.stream(IStream接口指针,true) # 直接使用指针创建对象,该指针的COM引用计数减一注意对象自身会增加COM引用计数并在释放时移除 ### fsys.stream(初始化数据,缓冲区长度) # 创建内存流文件,所有参数可选可选使用参数@3指定选项,此参数请参考库源码 ## fsysStreamObject 成员列表 # ### fsysStreamObject.close() # 关闭对象 ### fsysStreamObject.commit(flags) # 提交更改 ### fsysStreamObject.flush() # 提交更改兼容aardio标准流接口 ### fsysStreamObject.lines() # ```aardio for line in fsysStreamObject.lines(){ /*逐行读取数据，循环返回当前行（字符串值）。无论是否以文本模式打开，读取数据总是移除回车符与换行符。*/ } ``` ### fsysStreamObject.lockPointer() # 如果这是一个内存流, 锁定内存并返回内存指针，内存长度, 需要使用对象的unlockPointer()成员函数解锁内存写入内存流可能导致重新分配内存,所以返回的指针可能会变动 ### fsysStreamObject.read # 读数据 ### fsysStreamObject.read(-1) # 参数指定读取长度,-1为读到尾部参数也可以指定一个结构体用于填充读取的数据, 无参数读取一行 ### fsysStreamObject.read(0) # 是否未到达文件尾。如果已经到达文件尾返回 null，否则返回空字符串。注意在布尔表达式工 null 等于 false，空字符串等于 true。 ### fsysStreamObject.readAll() # 移到指针到文件头读取到文件尾返回所有数据 ### fsysStreamObject.readBuffer(buffer,读取长度) # 读取数据到 buffer, 参数@1应是 buffer 对象或指针，参数@2省略则默认为缓冲区长度。成功返回读取长度 ### fsysStreamObject.readTo # 读取直到以指定的字符串结束 ### fsysStreamObject.readTo('结束串') # 读取直到以指定的字符串结束,返回值不包含结束串, 该函数每次仅读取一个字节,效率较低 ### fsysStreamObject.reset() # 文件指针移动到开始类似seek(0,"set"),不同的是此函数返回对象自身 [返回对象:fsysStreamObject](#fsysStreamObject) ### fsysStreamObject.revert() # 撤消更改 ### fsysStreamObject.seek("cur",) # 移动至相对当前位置的指定偏移量 ### fsysStreamObject.seek("end") # 移动指针至结束处 ### fsysStreamObject.seek("end",) # 移动至相对结束处的指定偏移量 ### fsysStreamObject.seek("set") # 移动指针到开始 ### fsysStreamObject.seek("set",) # 移动至相对开始处的指定偏移量 ### fsysStreamObject.seek() # 得到当前位置 ### fsysStreamObject.size() # 得到数据长度 ### fsysStreamObject.stat() # 返回流状态返回值为STATSTG结构体 [返回对象:fsysstramSTATSTGObject](#fsysstramSTATSTGObject) ### fsysStreamObject.unlockPointer() # 解锁内存用lockPointer函数获取内存指针使用以后，必须调用此函数 ### fsysStreamObject.write # 写数据 ### fsysStreamObject.write(数据,长度) # 写入数据参数@1可使用字符串、buffer、指针、结构体等如果指定指针就必须明确指定写入长度 ### fsysStreamObject.writeBuffer(buffer,读取长度) # buffer 写入流, 参数@1应是 buffer 对象或指针，参数@2省略则默认为缓冲区长度 ## fsysstramSTATSTGObject 成员列表 # ### fsysstramSTATSTGObject.cbSize # 文件长度