cgio_is_link(int cgio_num, double id, int *link_len)¶cgio_num |
IN: Identifier for the open database file. |
id |
IN: Node identifier. |
link_len |
OUT: Total length of the link information (file_len + name_len). |
ier - Error status
r w m
Determines if the node indentified by id in the database given by cgio_num is a link or not. The function returns 0 if successfull, else an error code. If this node is a link, then the total length of the linked-to file and node information is returned in link_len. If the node is not a link, link_len will be 0.
cgio_link_size(int cgio_num, double id, int *file_len, int *name_len)¶cgio_num |
IN: Identifier for the open database file. |
id |
IN: Node identifier. |
file_len |
OUT: Length of the name of the linked-to file. This will be 0 if this is an internal link. |
name_len |
OUT: Length of the pathname of the linked-to node. |
ier - Error status
r w m
Gets the size of the linked-to file name in file_len and the node pathname length in name_len for the node identified by id in the database given by cgio_num. The function returns 0 for success, else an error code. If this is an internal link (link to a node in the same database), then file_len will be returned as 0.
cgio_create_link(int cgio_num, double pid, const char *name, const char *filename, const char *name_in_file, double *id)¶cgio_num |
IN: Identifier for the open database file. |
pid |
IN: Parent node identifier. |
name |
IN: Name of the link node. |
filename |
IN: Name of the linked-to file. If creating an internal link, then this should be NULL or an empty string. When reading an internal link, this will be returned as an empty string. |
name_in_file |
IN: Pathname of the linked-to node. |
id |
OUT: Node identifier. |
ier - Error status
- w m
Creates a link node as a child of the parent node identified by pid in the database given by cgio_num. The name of the node is given by name, the name of the linked-to file by filename, and the pathname to the linked-to node by name_in_file. If this is an internal link (link to a node in the same database), then filename should be defined as NULL or an empty string. The function returns 0 and the indentifier of the new node in id on success, otherwise an error code is returned.
cgio_get_link(int cgio_num, double id, char *filename, char *name_in_file)¶cgio_num |
IN: Identifier for the open database file. |
id |
IN: Node identifier. |
filename |
OUT: Name of the linked-to file. If creating an internal link, then this should be NULL or an empty string. When reading an internal link, this will be returned as an empty string. |
name_in_file |
OUT: Pathname of the linked-to node. |
ier - Error status
r w m
Gets the link information for the node identified by id in the database given by cgio_num. If successfull, the function returns 0 and the linked-to file name in filename and the node pathname in name_in_file. These strings are ‘0’-terminated, and thus should be dimensioned at least (file_len + 1) and (name_len + 1), respectively If this is an internal link (link to a node in the same database), then filename will be an empty string. The maximum length for a file name is given by CGIO_MAX_FILE_LENGTH (1024) and for a link pathname by CGIO_MAX_LINK_LENGTH (4096).