From 1568eb0c0d9bad48abcd71a3e1a767717ba92803 Mon Sep 17 00:00:00 2001 From: anod221 Date: Thu, 30 Aug 2018 22:06:48 +0800 Subject: [PATCH] Update README.md --- README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/README.md b/README.md index 5f16055..d9de6c8 100644 --- a/README.md +++ b/README.md @@ -3,16 +3,20 @@ AS3 ByteArray class for lua. # usage add the module: + ```lua luaopen_bytearr(L); ``` # constructor create( [capacity, [endian]] ) - Create an empty byte array. + init( [param1, param2, ...] ) - Create a byte array with initial bytes. Parameters should be a list of number or table. + load( str ) - Create a byte array with lua string object for read data. This byte array is read-only. return - A ByteArray object. + ```lua local x = ByteArray.create() -- create an empty byte array local y = ByteArray.init( 0, 1, 2, 3 ) -- create a byte array with initial bytes @@ -21,16 +25,25 @@ local z = ByteArray.load( "hello" ) -- create a byte array with a lua string obj # method for read data readByte() - Read a 8-bit signed integer from byte array. + readUnsignedByte() - Read a 8-bit unsigned integer from byte array. + readShort() - Read a 16-bit signed integer from byte array. + readUnsignedShort() - Read a 16-bit unsigned integer from byte array. + readInt() - Read a 32-bit signed integer from byte array. + readUnsignedInt() - Read a 32-bit unsigned integer from byte array. + readFloat() - Read a 32-bit float from byte array. + readDouble() - Read a 64-bit float from byte array. + readCString() - Read a string end with \0 from byte array. return - A lua number object. + ```lua local t = ByteArray.init( 1, 2, 3, 4, 5, 6 ) local a = t:readByte() -- a == 1 @@ -40,16 +53,25 @@ local c = t:readShort() -- c == 0x0403 # method for write data writeByte( s8 ) - Write a 8-bit signed integer to byte array. + writeUnsignedByte( u8 ) - Write a 8-bit unsigned integer to byte array. + writeShort( s16 ) - Write a 16-bit signed integer to byte array. + writeUnsignedShort( u16 ) - Write a 16-bit unsigned integer to byte array. + writeInt( s32 ) - Write a 32-bit signed integer to byte array. + writeUnsignedInt( u32 ) - Write a 32-bit unsigned integer to byte array. + writeFloat( f32 ) - Write a 32-bit float to byte array. + writeDouble( f64 ) - Write a 64-bit float to byte array. + writeCString( str ) - write a string end with \0 to byte array. return - The ByteArray object itself. + ```lua local buf = ByteArray.create() buf:writeByte(1):writeByte(2):writeInt(0x0403) @@ -57,7 +79,9 @@ buf:writeByte(1):writeByte(2):writeInt(0x0403) # method for copying data between ByteArray object readBytes( to[, offset, length] ) - Read data to first parameter(a ByteArray object), the range for the target byte array is start from offset with length. + writeBytes( from[, offset, length] ) - Write data from first parameter(a ByteArray object), the range for the data is start from offset with length. + ```lua local buf = ByteArray.init( 1, 2, 3, 4, 5 ) local d = ByteArray.create() @@ -66,6 +90,7 @@ buf:readBytes( d ) # member position start position for reading / writing data. + ```lua local buf = ByteArray.init( 1, 2, 3, 4, 5 ) buf.position = 3 @@ -76,6 +101,7 @@ print( buf.position ) -- 5 # member length set / get length + ```lua local buf = ByteArray.init( 1,2,3,4,5,6,7 ) print( buf.length ) @@ -85,6 +111,7 @@ for i=1, #buf do print(buf[i]) end # member endian set / get endian + ```lua local buf = ByteArray.init(2,3) buf.endian = ByteArray.LITTLE_ENDIAN @@ -92,6 +119,7 @@ buf.endian = ByteArray.LITTLE_ENDIAN # indexing index start from 1 to length. If out of range, return -1. + ```lua local buf = ByteArray.init(2,3) print(buf[1])