6.7.5SHOW USE GROUP
Syntax
SHOW USE GROUP
[post_processing_option]
[output_redirecting_option]
Description
Show (i.e. get) the HDF5 group currently in use.
Parameter(s)
post_processing_option – optional option that transforms the result set according to the programmer’s needs, such as ordering or truncating (please refer to the section PROCESSING for additional information).
output_redirecting_option – optional option that specifies the cursor in use, an HDF5 object (i.e. dataset or attribute), a (text, binary, or Excel) file, or memory (i.e. user-defined variable) to write the result set into (please refer to the subsection INTO for additional information). If not specified, the cursor in use is populated with the result set instead (please refer to the chapter CURSOR for additional information).
Return
The HDF5 group currently in use as an HDFQL_VARCHAR or nothing (in case no file is in use).
Example(s)
# use (i.e. open) an HDF5 file named "my_file.h5"
USE FILE my_file.h5
# show (i.e. get) current working group (should return "/")
SHOW USE GROUP
# create an HDF5 group named "my_group"
CREATE GROUP my_group
# set group currently in use to "my_group" (more precisely "/my_group")
USE GROUP my_group
# show (i.e. get) current working group (should return "/my_group")
SHOW USE GROUP
# create two HDF5 groups named "my_subgroup0" and "my_subgroup1" (both groups will be created in group "/my_group")
CREATE GROUP my_subgroup0, my_subgroup1
# set group currently in use to "my_subgroup0" (more precisely "/my_group/my_subgroup0")
USE GROUP my_subgroup0
# show (i.e. get) current working group (should return "/my_group/my_subgroup0")
SHOW USE GROUP
# set group currently in use to "." (the group currently in use will not change as "." refers to the current working group itself)
USE GROUP .
# show (i.e. get) current working group (should return "/my_group/my_subgroup0")
SHOW USE GROUP
# set group currently in use to "my_subgroup1" located one level up (more precisely "/my_group/my_subgroup1")
USE GROUP ../my_subgroup1
# set group currently in use two levels up (should be "/")
USE GROUP ../..
# show (i.e. get) current working group (should return "/")
SHOW USE GROUP