【Godot4.2】GDScript数组分类及类型化数组和紧缩数组概述

已于 2024-03-06 18:03:00 修改
阅读量1.3k 收藏 13
点赞数 8
分类专栏： Godot4.0 文章标签： godot gdscript 数组 类型化数组 紧缩数组
于 2024-03-06 17:53:05 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/graypigen1990/article/details/136503403
版权

概述

GDScript的数组是一种很常用的数据类型。本文主要阐述一下GDScript数组分类，以及官方文档和大多数视频或教程较少提及的类型化数组和紧缩数组。

GDScript数组分类

通过反复查阅GDScript内置文档并进行细节比较，发现GDScript的数组，可以划分为三类：

  • 普通数组：Array，不限定元素的类型，同一个数组可以存储不同类型的数据元素。
  • 类型化数组：Array[type]，在Array的基础上限定只能存储一种类型的数据元素。
  • 紧缩数组：Packed*Array，数据紧密存放，在数组比较大时可以节省内存。包括：PackedInt32Array、PackedInt64Array、PackedFloat32Array、PackedFloat64Array、 PackedStringArray、PackedVector2Array、PackedVector3Array、PackedColorArray、PackedByteArray。其中PackedByteArray代表二进制的字节数组，与其他紧缩数组在代表的意义和所提供的方法方面是完全不同的。

关于数组分类总结如下表：

分组类中文名称类型(typeof)备注
普通数组Array普通数组TYPE_ARRAY元素类型可不一致
类型化数组Array[type]类型化数组TYPE_ARRAY元素类型必须一致
紧缩数组PackedByteArray字节紧缩数组TYPE_PACKED_BYTE_ARRAY音频、图片等可能会以此形式存储
↑PackedInt32Array32位整数紧缩数组TYPE_PACKED_INT32_ARRAY紧缩数组中比较特殊的一位
↑PackedInt64Array64位整数紧缩数组TYPE_PACKED_INT64_ARRAY方法完全一样，但参数不一样
↑PackedFloat32Array32位浮点数紧缩数组TYPE_PACKED_FLOAT32_ARRAY
↑PackedFloat64Array64位浮点数紧缩数组TYPE_PACKED_FLOAT64_ARRAY
↑PackedStringArray字符串紧缩数组TYPE_PACKED_STRING_ARRAY
↑PackedVector2ArrayVector2紧缩数组TYPE_PACKED_VECTOR2_ARRAY
↑PackedVector3ArrayVector3紧缩数组TYPE_PACKED_VECTOR3_ARRAY
↑PackedColorArrayColor紧缩数组TYPE_PACKED_COLOR_ARRAY

普通数组

GDScript普通数组的使用方法，请查阅：
【Godot4.2】普通数组Array使用全解析 一文。

类型化数组

  • 类型化数组是在普通数组之上添加了一层限定，即限定了所存储的元素类型。
  • 形式为Array[type]，其中type可以是基础数据类型或者Object及其子类型（包括各种Node、Resource等）。

申明与创建

可以用如下形式创建类型化数组：

var arr1:Array[int]          # 申明一个元素都是int类型的数组
var arr2:Array[String]       # 申明一个元素都是String类型的数组
var arr3:Array[Button]       # 申明一个元素都是Button控件的数组
var arr4:Array[PackedScene]  # 申明一个元素都是PackedScene的数组

可以看到，只需要对申明的数组变量用Array[type]形式显式申明其类型即可。
其他的操作与普通Array没有区别。

同时Array提供了一个构造函数，可以用构造函数形式创建类型化数组。其形式如下：

Array(base:Array,type:int,class_name:StringName,script:Variant)

其中：

  • base：是要被类型化的Array数组，可以传入一个空数组。
  • type：指定元素的类型，基础数据类型int、float、String等，以及内置或自定义的Node、Resource等
  • class_name：是具体的类名，比如Button、PackedScene等。
  • script:自定义节点类型或资源类型的脚本？(尚有疑问，谨待确认)

比如，申明一个PackedScene类型作为元素的类型化数组，我们可以用常用形式：

var arr:Array[PackedScene]     # 形式1

也可以用构造函数形式：

var arr = Array([],TYPE_OBJECT,"PackedScene",null)   # 形式2

两者申明的类型化数组没有本质上的区别，只是后者提供了一种字符串参数形式创建的类型化数组的方法，在某些场景下可能用得到。

数组的类型化判断以及元素类型信息获取

Array类型提供了几个方法用于判断数组是否是类型化数组，以及获取元素类信息等。

  • is_typed()：判断一个数组是否是类型化的。
    注意：Packed*Array不算在Array或者类型化数组范畴，也就没有is_typed()等方法，所以不能用is_typed()判断其是否类型化。
var arr1:Array[PackedScene]
var arr2 = []

print(arr1.is_typed()) # true
print(arr2.is_typed()) # flase
  • is_same_typed()：判断两个类型化数组的类型是否相同。
var arr1:Array[PackedScene]
var arr2:Array[PackedScene]
var arr3:Array[int]

print(arr1.is_same_typed(arr2)) # true
print(arr1.is_same_typed(arr3)) # flase
  • get_typed_builtin()：返回类型化的数组的内置类型（Variant.Type），如果是内置数据类型，返回相应的类型常量，如果是节点或资源类型，统一返回TYPE_OBJECT (数值24)
var arr1:Array[int]
var arr2:Array[Button]
var arr3:Array[PackedScene]

print(arr1.get_typed_builtin()) # 2 = TYPE_INT
print(arr2.get_typed_builtin()) # 24 = TYPE_OBJECT
print(arr3.get_typed_builtin()) # 24 = TYPE_OBJECT
  • get_typed_class_name()返回类型化数组具体的元素类型名称，基础数据类型返回空字符串，节点或资源类型返回具体类名。
var arr1:Array[int]
var arr2:Array[Button]
var arr3:Array[PackedScene]

print(arr1.get_typed_class_name()) # ""
print(arr2.get_typed_class_name()) # "Button"
print(arr3.get_typed_class_name()) # "PackedScene"
  • get_typed_script():如果是自定义节点或资源类型，可以返回其脚本对象，内置数据类型或内置节点、资源类型，则返回<Object#null>。
var arr:Array[PackedScene]
print(arr.get_typed_builtin())     # 24 = TYPE_OBJECT
print(arr.get_typed_class_name())  # "PackedScene"
print(arr.get_typed_script())      # <Object#null>

紧缩数组

Packed*Array形式的数组类型被称为“紧缩数组”类型。包括：

类中文名称类型(typeof)
PackedByteArray字节紧缩数组TYPE_PACKED_BYTE_ARRAY
PackedInt32Array32位整数紧缩数组TYPE_PACKED_INT32_ARRAY
PackedInt64Array64位整数紧缩数组TYPE_PACKED_INT64_ARRAY
PackedFloat32Array32位浮点数紧缩数组TYPE_PACKED_FLOAT32_ARRAY
PackedFloat64Array64位浮点数紧缩数组TYPE_PACKED_FLOAT64_ARRAY
PackedStringArray字符串紧缩数组TYPE_PACKED_STRING_ARRAY
PackedVector2ArrayVector2紧缩数组TYPE_PACKED_VECTOR2_ARRAY
PackedVector3ArrayVector3紧缩数组TYPE_PACKED_VECTOR3_ARRAY
PackedColorArrayColor紧缩数组TYPE_PACKED_COLOR_ARRAY

紧缩数组类型与普通数组、类型化数组的关系

  • Array和Packed*Array在内存中都是连续存放的，但是前者存放的是Variant类型， Variant类型固定占20字节，并且可以在其中存储几乎任何引擎数据类型。
  • 类型化数组是限定Array只能存储一种类型的数据元素，也就是将Variant限定为了具体的数据类型（比如说int），但其Array的本质和用Variant类型存储数据元素的本质没有变化。
  • 而具体的Packed*Array，则使用相应的具体类型，而不是Variant类型存储元素数据，所以相比类型化数组更加紧凑，所以相对普通Array和类型化数组Array[type]被称为紧缩数组。

在这里插入图片描述

字节紧缩数组（PackedByteArray）

字节紧缩数组PackedByteArray算是比较特殊的一种紧缩数组，它的API和其他几种紧缩数组的不同，用途也不同

数组和紧缩数组间的转化关系

  • 普通数组Array（包括类型化数组Array[type]）可以通过Packed*Array(Array)形式也就是相应的紧缩数组的构造函数形式转化为紧缩数组，其过程会对元素类型进行强制转换；
var arr1:Array = [1,"张三",Button.new()]
var pk_arr1 = PackedInt32Array(arr1)
var pk_arr2 = PackedFloat32Array(arr1)
var pk_arr3 = PackedStringArray(arr1)
var pk_arr4 = PackedByteArray(arr1)

print(arr1)    # [1, "张三", <Button#7394641913158>]
print(pk_arr1) # [1, 0, 0]
print(pk_arr2) # [1, 0, 0]
print(pk_arr3) # ["1", "张三", "<Button#6977593879327>"]
print(pk_arr4) # [1, 0, 0]

var arr1:Array[Button] = [Button.new(),Button.new()]
var pk_arr1 = PackedInt32Array(arr1)
var pk_arr2 = PackedFloat32Array(arr1)
var pk_arr3 = PackedStringArray(arr1)
var pk_arr4 = PackedByteArray(arr1)

print(arr1)    # [<Button#8468215966358>, <Button#8468266298058>]
print(pk_arr1) # [0, 0]
print(pk_arr2) # [0, 0]
print(pk_arr3) # ["<Button#8468215966358>", "<Button#8468266298058>"]
print(pk_arr4) # [0, 0]
  • Packed*Array(Array)可以通过to_byte_array()方法转换为PackedByteArray ；
var arr1:PackedInt32Array = [1,2,4,5,6,7,8]
var bt_arr1 = arr1.to_byte_array()

print(bt_arr1 is PackedByteArray) # true
  • PackedByteArray则可以使用to_float32_array()、to_float64_array()、to_int32_array()、to_int64_array()转化为PackedFloat32Array ，PackedFloat64Array ，PackedInt32Array 和PackedInt64Array ；

普通数组转字节紧缩数组

var arr = ["张三","李四","王五"]
	
print(PackedByteArray(arr)) # [0, 0, 0]

var arr:PackedStringArray = ["张三","李四","王五"]
	
print(arr.to_byte_array()) # [208, 234, 206, 112, 47, 1, 0, 0, 192, 232, 206, 112, 47, 1, 0, 0, 128, 233, 206, 112, 47, 1, 0, 0]

可以看到普通的字符串数组用PackedByteArray()构造函数直接转换是无效的。
而是应该将数组显示申明为PackedStringArray类型，再调用to_byte_array()方法转换为PackedByteArray。

var arr = [1,2,3]
	
print(PackedByteArray(arr)) # [1,2,3]

var arr = [1.5,23.45,36]
	
print(PackedByteArray(arr)) # [1, 23, 36]

普通的纯数字数组通过PackedByteArray()构造函数直接转换有效，但浮点数会被自动转化为整数（向下取整）。

提示：
直接用print()方式打印PackedByteArray其每个字节都显示为10进制数字，有时候不是太利于理解。
在《对数组的函数扩充》一文中，编写了相应的函数可以将10进制显示为2进制。下文中显示的二进制形式就是基于相应函数而来。

整形、浮点型紧缩数组转PackedByteArray

var arr1:PackedInt32Array = [1]
var arr2:PackedInt64Array = [1]
var arr3:PackedFloat32Array = [1.5]
var arr4:PackedFloat64Array = [1.5]

print(arr1.to_byte_array()) # [1, 0, 0, 0]
# [00000001,00000000,00000000,00000000]

print(arr2.to_byte_array()) # [1, 0, 0, 0, 0, 0, 0, 0]
# [00000001,00000000,00000000,00000000,00000000,00000000,00000000,00000000]

print(arr3.to_byte_array()) # [0, 0, 192, 63]
# [00000000,00000000,11000000,00111111]

print(arr4.to_byte_array()) # [0, 0, 0, 0, 0, 0, 248, 63]
# [00000000,00000000,00000000,00000000,00000000,00000000,11000000,00111111]

可以看到：

  • Int32、Float32占4字节,Int64、Float64占8字节。
  • 因此PackedInt32Array、PackedFloat32Array的一个元素转为PackedByteArray的4个元素，分别对应4个字节
  • 反过来PackedByteArray转PackedInt32Array、PackedFloat32Array时，是将4个元素转化为1个整数

下图表示一个包含2个元素的PackedInt32Array，在内存中的实际表示。而其每个字节组成的数组就可以看为其PackedByteArray形式。

PackedStringArray转PackedByteArray

var arr1:PackedStringArray = ["a"]
var arr2:PackedStringArray = ["啊"]
var arr3:PackedStringArray = ["a","b","c"]
var arr4:PackedStringArray = ["啊","你好","张三"]

print(arr1.to_byte_array()) # [16, 34, 29, 73, 196, 2, 0, 0]

print(arr2.to_byte_array()) # [80, 27, 29, 73, 196, 2, 0, 0]

print(arr3.to_byte_array()) 
# [16, 34, 29, 73, 196, 2, 0, 0, 144, 90, 29, 73, 196, 2, 0, 0, 208, 35, 29, 73, 196, 2, 0, 0]

print(arr4.to_byte_array()) 
# [80, 27, 29, 73, 196, 2, 0, 0, 128, 119, 41, 72, 196, 2, 0, 0, 0, 121, 41, 72, 196, 2, 0, 0]

print("a".to_ascii_buffer())   # [97]
print("a".to_utf8_buffer())	   # [97]
print("a".to_utf16_buffer())   # [97, 0]
print("a".to_utf32_buffer())   # [97, 0, 0, 0]
print("a".to_wchar_buffer())   # [97, 0]

var string = "张三"
var byte = string.to_utf8_buffer()
print(byte)	              # [229, 188, 160, 228, 184, 137]
print(slices_arr(byte,3)) # [[229, 188, 160], [228, 184, 137]]
print(show_byte_array_string(byte,3))
# ["11100101", "10111100", "10100000"],
# ["11100100", "10111000", "10001001"]

可以看到PackedStringArray转为PackedByteArray后，存储的并不是字符串本身的二进制编码形式，而是指向字符转在内存中的地址（地址占8个字节）。

PackedColorArray --> PackedByteArray

Color以RGBA形式构造，每一个分量为一个Float32，则在PackedByteArray中一个颜色是由四组四个字节的形式表示。

var arr:PackedColorArray = [Color.YELLOW]
var byte = arr.to_byte_array()

print(byte)	# [0, 0, 128, 63, 0, 0, 128, 63, 0, 0, 0, 0, 0, 0, 128, 63]

print(slices_arr(byte,4)) 
# [[0, 0, 128, 63], [0, 0, 128, 63], [0, 0, 0, 0], [0, 0, 128, 63]]
# [r,g,b,a]

print(show_byte_array_string(byte,4))
# ["00000000", "00000000", "10000000", "00111111"],    # R
# ["00000000", "00000000", "10000000", "00111111"],    # G
# ["00000000", "00000000", "00000000", "00000000"],    # B
# ["00000000", "00000000", "10000000", "00111111"]     # A

PackedVector2Array/PackedVector3Array --> PackedByteArray

var arr:PackedVector2Array = [Vector2(100,100)]
	
var byte = arr.to_byte_array()
print(byte)	              # [0, 0, 200, 66, 0, 0, 200, 66]
print(slices_arr(byte,4)) # [[0, 0, 200, 66], [0, 0, 200, 66]]

print(show_byte_array_string(byte,4))
# ["00000000", "00000000", "11001000", "01000010"],   # X
# ["00000000", "00000000", "11001000", "01000010"]    # Y

var arr:PackedVector3Array = [Vector3(100,100,100)]
	
var byte = arr.to_byte_array()
print(byte)	              # [0, 0, 200, 66, 0, 0, 200, 66, 0, 0, 200, 66]
print(slices_arr(byte,4)) # [[0, 0, 200, 66], [0, 0, 200, 66], [0, 0, 200, 66]]

print(show_byte_array_string(byte,4))
# ["00000000", "00000000", "11001000", "01000010"],  # X
# ["00000000", "00000000", "11001000", "01000010"],  # Y
# ["00000000", "00000000", "11001000", "01000010"]   # Z

基础数据类型与二进制形式转换

字符串转二进制

print("a".to_ascii_buffer())   # [97]
print("a".to_utf8_buffer())	   # [97]
print("a".to_utf16_buffer())   # [97, 0]
print("a".to_utf32_buffer())   # [97, 0, 0, 0]
print("a".to_wchar_buffer())   # [97, 0]
巽星石
关注
  • 8
    点赞
  • 踩
  • 13
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
godot游戏引擎自学入门笔记--GDScript语言导论，官方文档翻译（七）
暗色调的博客
04-05 1547
变量与赋值 All variables in a dynamically typed language are “variant”-like. This means that their type is not fixed, and is only modified through assignment. Example: 动态类型语言中的所有变量都是“可变”的。这意味着它们的类型不是固定的，...
【Godot4.2】普通数组Array使用全解析
巽的博客
03-06 1888
本篇总结和介绍一下Godot普通数组Array的一些常见用法，包括增、删、查、改和排序、去重、元素计数以及批量操作等。Godot4.2的数组可以分为普通数组Array）、类型化数组)和紧缩数组【Godot4.2】GDScript数组分类及类型化数组和紧缩数组概述一文。@toolvar arr = ["百度","阿里巴巴","美团","支付宝"];# 原始数组arr.shuffle() # 打乱顺序print(arr) # ["阿里巴巴", "百度", "支付宝", "美团"]
Godot 学习笔记——GDScript
最新发布
weixin_38844255的博客
05-22 1115
extends：继承。_ready()：第一次加载入场景中调用，相当于Unity中的Start()。_process(delta)：每一帧调用，相当于Unity中的Update()。delta是自上一帧经过的时间，类似于Time.deltatime。pass：关键字pass的作用相当于空函数体（"{}"），什么也不用做。
在Godot实现按照固定大小切割数组（分组）
weixin_43539313的博客
10-06 918
在Godot实现按照固定大小切割数组（分组）
Godot着色器语言
开发游戏的老王
09-01 2010
引言 Godot 使用的了一种非常接近GLSL ES 3.0的着色器语言,并且支持其绝大多数的数据类型和函数，尚未完全支持的部分也会逐渐增加进去。 如果你对GLSL熟悉的话，可以直接阅读 《Godot Shader Migration Guide》 以帮助你从标准GLSL过渡到Godot Shader。 数据类型 支持绝大多数GLSL ES 3.0数据类型: 类型 描述 void ...
[Godot] GDScript 和 Python 脚本创建类与对象的异同
先说一下，就简单地写点儿氵文，不是博客，只是我的笔记本
01-07 1159
.
godot-gdscript-toolkit:独立的GDScript工具集-解析器，lint和格式化程序
05-14
GDScript工具包 该项目为GDScript日常工作提供了一组工具。 目前，它提供： 生成用于调试和教学目的的语法分析树的语法分析器。 根据某些预定义配置执行静态分析的短毛猫。 根据某些预定义规则对代码进行格式化...
intellij-gdscript:Godot Engine和GDScript支持插件，用于基于IntelliJ的IDE
05-09
IntelliJ IDEA的GDScript插件特征语法高亮代码完成res://完成支持语法的代码选择跑步场景LSP支持（实验性） 从v2019.3。开始，可与所有基于IntelliJ的IDE一起使用。用途与发展./gradlew buildPlugin构建插件发行版以...
tree-sitter-gdscript：Godot的GDScript的tree-sitter语法
02-01
用于stree sitter的GDScript语法。 去做 格式说明符 陈述 setget 出口 const 信号 文字 @“ NodePath / StringName” $ node和$“ ../ node” 经营者 是 如 关键字陈述 断点 可变属性 现成的 这些...
ZoneLoadingSystem:Godot动态区域加载系统
04-01
这是Godot的动态区域加载系统，它负责为您管理区域管理，在玩家探索世界时加载和卸载区域，并使用后台线程来最大程度地减少性能故障。 这允许拥有巨大的无缝世界而无需加载屏幕。 该系统适用于手工制作的区域，例如...
gdscript-docs-maker：从Godot GDScript代码创建文档和类引用
02-05
GDScript文档制作器 ... 注意：此程序需要Godot 3.2+和Python 3.7+才能运行。 正在安装 您可以使用pip安装GDScript Docs Maker python软件包： # On Linux and MacOS: python3 -m pip install gdscript
GDScript
engpih的博客
12-12 2358
GDScript 一，GDScript的简单介绍 GDScript是官方文档在API项里提到的第一组内容，这里介绍了戈多引擎核心内置GDScript函数，包括数学函数和其他实用程序，在任何结点的GDScript里都可以出现这些函数。 然后贴一下链接： https://docs.godotengine.org/zh_CN/stable/classes/class_@gdscript.html 二，GDScript内容的详细介绍 1.（constant）常量 首先godot里内置了四种常量，分别是PI，TAU，
【Godot】物品数据数据管理
qq_37280924的博客
02-20 3582
Godot 3.4.2 用来管理物品的数据，废话不多说，直接上代码，核心代码如下： #============================================================ # Item Manager #============================================================ # 物品管理 # * 调用 add_item 方法传入 Dictionary 类型的数据进行添加物品数据 #==================.
godot游戏引擎自学入门笔记--GDScript语言细节，官方文档翻译（八）
暗色调的博客
04-05 3233
标识符 Any string that restricts itself to alphabetic characters (a to z and A to Z), digits (0 to 9) and _ qualifies as an identifier. Additionally, identifiers must not begin with a digit. Identifiers...
【GDScript】保存/加载物品装备数据
qq_37280924的博客
03-26 745
> Godot 3.3 rc6 接着上个文章 【Godot】加载文件数据 我们开始给装备栏和物品栏制作保存数据的功能 我们在 FileManager.gd 脚本里添加如下代码，用来保存加载数据 ## 文件是否存在 ## @path 文件路径 func exists_file(path: String) -> bool: var file = File.new() var exists = file.file_exists(path) file.close() return exists
GDScript 导出变量 （Godot4.0）
热门推荐
巽的博客
03-05 3万+
Godot4.0新的导出变量语法
Array类型
开发游戏的老王
10-23 902
Godot Engine 3.2 Alpha2 Array是Godot的内置类型之一，它非常灵活，已经内置了很多方法，可直接充当队列，栈，链表等数据结构 常用方法 类型 方法名 说明 Array Array ( PoolColorArray from ) Array Array ( PoolVector3Array from ) Array Array ( Po...
开始跟着视频学python，第八天mark【2D Lists 二维数组，矩阵，列表数组】
GODOT鸣人的博客
04-22 308
视频位置：121:50 2D Lists 二维数组，矩阵。 突然想起了大学里的复变函数，掩面哭过…
godot 随机获得数组元素
04-23
可以使用Godot引擎中提供的randi()函数来随机获取数组元素。具体实现方法如下： 1. 创建一个数组，例如array=[“元素1”，“元素2”，“元素3”]。 2. 使用randi()函数来生成一个0到数组长度减1之间的随机整数索引号，例如index=randi()%array.size()。 3. 使用数组索引号来获取对应的数组元素，例如element=array[index]。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

巽星石

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值