This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
UnigineEditor
界面概述
资产工作流程
设置和首选项
项目开发
调整节点参数
Setting Up Materials
Setting Up Properties
照明
Landscape Tool
Sandworm
使用编辑器工具执行特定任务
Extending Editor Functionality
嵌入式节点类型
Nodes
Objects
Effects
Decals
光源
Geodetics
World Objects
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
Usage Examples
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
创建内容
Content Optimization
Materials
Art Samples
Tutorials
注意! 这个版本的文档是过时的,因为它描述了一个较老的SDK版本!请切换到最新SDK版本的文档。
注意! 这个版本的文档描述了一个不再受支持的旧SDK版本!请升级到最新的SDK版本。

Foreachkey语句

警告
UnigineScript的应用范围仅限于实现与材料相关的逻辑(材料表达式,可编写脚本的材料,画笔材料)。 不要将UnigineScript用作应用程序逻辑的语言,请改用C#/C++,因为这些API是首选的。 无法保证UnigineScipt中新引擎功能的可用性(超出其应用范围),因为当前的支持级别仅假设已解决关键问题。

foreachkey架构提供另一种方法对矢量贴图进行迭代。通过这种语句为每个索引或所给容器内的键执行某些代码。

语法

源代码 (UnigineScript)
foreachkey(key_variable; map; loop_increment) {
	// some_code;
 }

部分

  • key_variable为当前间(或索引)。内部容器的游标会移至下一个键值对(或者索引项)所在处。
  • key_variable的类型无关紧要。
  • 每个迭代的最后执行loop_increment,此为可选选项。

示例

  • 源代码 (UnigineScript)
    int map[] = ( "begin" : "flower", "middle" : "fruit", "end" : "tree" );
    foreachkey(int i; map) {
    	log.message("%s\t=>\t%s\n",i,map[i]);
    }
    结果为:
    输出
    begin   =>      flower
    end     =>      tree
    middle  =>      fruit
  • 源代码 (UnigineScript)
    int map[] = ( "begin" : "flower", "middle" : "fruit", "end" : "tree" );
    foreachkey(int i, j = 0; map; j++) {
    	log.message("%d: %s\t=>\t%s\n",j,i,map[i]);
    }
    结果为:
    输出
    0: begin   =>      flower
    1: end     =>      tree
    2: middle  =>      fruit
注意
在执行之前,以升序的方式将键存储起来。

foreachkey模块内部键的更改不会影响到贴图,但可直接更改值。

源代码 (UnigineScript)
int map[] = ( "begin" : "flower", "middle" : "fruit", "end" : "tree" );
foreachkey(int i; map) {
	i = "first";	// 贴图不受影响
	map[i] = -9.6;	// 贴图发生变化
}

Nesting foreachkey嵌套foreachkey#

如果在另一个foreachkey结构内调用了foreachkey 结构,对于每个模块而言应将每个贴图的副本存储起来。(这种方法需要的性能更高。)

源代码 (UnigineScript)
int map[] = ( "1" : "head", "2" : "foot" );

int copy[];
copy.copy(map);

foreachkey(int i; map) {
	foreachkey(int j; copy)	// foreachkey(int j; map)会生成一个错误
	{
		log.message("%s\t->\t%s\t%s\t->\t%s\n",i,map[i],j,map[j]);
	}
}
此示例的输出结果为:
输出
1	->	head	1	->	head
1	->	head    2	->	foot
2	->	foot	1	->	head
2	->	foot	2	->	foot
最新更新: 2021-04-29
Build: ()