语法

描述

[status,opdata_out] = H5L.visit_by_name(loc_id,group_name,index_type,order,iter_func,opdata_in,lapl_id)递归地遍历一个组内和组下的所有链接，以执行一个函数句柄为的公共函数iter_func．迭代的起点由位置id和相对组名的配对指定。链接访问属性列表，lapl_id，可能会影响结果，具体取决于所遍历的链接类型。

index_type而且订单建立迭代。index_type指定要使用的索引。如果链接没有按照索引类型建立索引，那么它们将首先按照该索引进行排序，然后迭代将开始。如果链接已经建立了这样的索引，排序步骤就没有必要了，这样迭代就可以更快地开始。有效值包括以下内容。

请注意传入的索引类型index_type是一个全力以赴的设定。如果应用程序传入一个指示创建顺序迭代的值，并且遇到没有按照创建顺序跟踪的组，则该组将按名称或名称顺序按字母-数字顺序迭代。(名称顺序是HDF5库使用的本机顺序，并且始终可用。)

订单中指定的索引检查对象的顺序index_type．有效值包括以下内容。

回调函数iter_func必须有以下签名:

函数[status,opdata_out] = iter_func(group_id,name,opdata_in)

opdata_in中传递给迭代的第一步的用户定义值或结构iter_funcopdata_in参数。的opdata_out迭代步骤的opdata_in对于下一个迭代步骤。最后一个opdata_out在迭代结束时，返回给调用者为opdata_out．

状态返回的值iter_func解释如下。