# win.guid 库模块帮助文档
## win 成员列表 #
### win.guid("GUID、CLSID、ProgID等") #
字符串转换为 GUID,
参数支持ProgID,CLSID,GUID,
失败返回null空值
### win.guid() #
创建 GUID 结构体,初始化为空值。
可使用 win.guid.create 函数创建 GUID 结构体并初始化为唯一值。
返回的 win.guid 对象通过 `++` 或 `+` 操作符连接时会自动转换为字符串。
win.guid 对象可以使用 tostring 函数转换为大写字符串。
tostring 参数 @2 指定是否小写,参数@3指定是否添加大括号,
tostring 参数@2 也可用字符串指定11个数值参数的格式化串,
[返回对象:winGuidObject](#winGuidObject)
### win.guid(数值,数值,数值,'\x00\x00\x00\x00\x00\x00\x00\x00') #
创建GUID结构体
参数@4也可以改为包含8个字节数值的数组或者展开为8个数值参数
## win.guid 成员列表 #
### win.guid.create() #
创建 GUID 结构体并初始化为唯一值。
[返回对象:winGuidObject](#winGuidObject)
### win.guid.fromString("字符串参数") #
字符串转换为 GUID 结构体。
参数支持 ProgID,CLSID,GUID （32 个 16 进制字符以及可选的 4 个短横线）格式字符串,
失败返回 null 空值。
注意 win.guid 对象可以使用 tostring 函数转换为字符串,
tostring 参数 @1 指定是否小写（或指定格式化字符串）,参数 @2 指定是否添加大括号,
[返回对象:winGuidObject](#winGuidObject)
### win.guid.fromString() #
[返回对象:winGuidObject](#winGuidObject)
### win.guid.toProgId("字符串参数") #
GUID转换为字符串格式的 ProgId
失败返回null空值
### win.guid.valid() #
[返回对象:winGuidObject](#winGuidObject)
### win.guid.valid(GUID对象) #
判断是否有效GUID对象,
如果参数是ProgID,CLSID,GUID,则尝试转换,
转换成功则返回GUID对象,否则返回空
## winGuidObject 成员列表 #
### winGuidObject.Data1 #
INT类型
### winGuidObject.Data2 #
WORD类型
### winGuidObject.Data3 #
WORD类型
### winGuidObject.Data4 #
字符串值,也可以指定包含多个字节值的数组
### winGuidObject.create() #
初始化为唯一值，返回自身
[返回对象:winGuidObject](#winGuidObject)
### winGuidObject.fromString("字符串参数") #
字符串转换为 GUID 结构体,返回自身,
也可以直接写到 win.guid 参数中,
可使用 tostring 函数将 GUID 结构体重新转换为字符串
tostring 参数@2指定是否小写,参数@3指定是否添加大括号,
tostring 参数@2 也可用字符串指定11个数值参数的格式化串
[返回对象:winGuidObject](#winGuidObject)
### winGuidObject.hex() #
转换为 16 进制格式字符串。
可选使用参数 @1 自定义 16 进制前缀字符，默认为空字符串。
### winGuidObject.isNull() #
是否等于GUID_NULL，也就是结构体内存的所有字节值为0
### winGuidObject.toProgId() #
CLSID转换为ProgId,返回字符串
### winGuidObject.toString #
转换为字符串,也支持通过 tostring 自动调用此函数
### winGuidObject.toString("%08X%04X%04X%02X%02X%02X%02X%02X%02X%02X%02X") #
转换为字符串,自定义 11 个数值参数的格式化串
### winGuidObject.toString("%X") #
转换为 32 位 16 进制字符串，大写，无短横线。
参数 %X" 自动转换为 "%08X%04X%04X%02X%02X%02X%02X%02X%02X%02X%02X"。
也可以写为 `tostring(guid,"%X")` 。
### winGuidObject.toString("%x") #
转换为 32 位 16 进制字符串，小写，无短横线。
参数 %x" 自动转换为 "%08x%04x%04x%02x%02x%02x%02x%02x%02x%02x%02x"。
也可以写为 `tostring(guid,"%x")` 。
### winGuidObject.toString(是否小写,是否添加大括号) #
转换为字符串,生成格式:
00000000-0000-0000-0000-000000000000
### winGuidObject.unpack() #
转换并返回 11 个数值