5.2.38hdfql_cursor_get_int

#Syntax

#Description

Get the current element of a cursor named cursor as an INT. In other words, the current element is interpreted as an “int” C data type and returned as a pointer to such type. If the result set is empty or the cursor is located before or after the first or last element of the result set, the returned element is NULL.

#Parameter(s)

cursor – pointer to a cursor to get the current element as an INT. If the pointer is NULL (in C), the current element of the cursor in use is returned instead. The equivalent of a NULL pointer in C++, Java, Python, C#, Fortran, R, and MATLAB HDFql wrappers is NULL, null, None, null, NULL(), NULL, and NaN, respectively. While in C cursor is mandatory, in C++, Java, Python, C#, Fortran, R, and MATLAB it is optional (when not specified, the current element of the cursor in use is returned instead).

#Return

int * – pointer to the current element of the cursor. If there is no current element, the pointer will be NULL.

#Example(s)

// create an HDF5 dataset named "my_dataset" of data type int of one dimension (size 3) 
hdfql_execute("CREATE DATASET my_dataset AS INT(3)");

// insert (i.e. write) values into dataset "my_dataset" 
hdfql_execute("INSERT INTO my_dataset VALUES(12, 34, 23)");

// select (i.e. read) data from dataset "my_dataset" and populate cursor in use with it  
hdfql_execute("SELECT FROM my_dataset");

// move the cursor in use to next position within the result set (i.e. first position) 
hdfql_cursor_next(NULL); 

// display current element of the cursor in use as an unsigned short (should be "Current element of cursor is 12")
printf("Current element of cursor is %d\n", *hdfql_cursor_get_int(NULL));