.TH "globus_rsl_constructors" 3 "Fri Sep 2 2016" "Version 10.11" "globus_rsl" \" -*- nroff -*-
.ad l
.nh
.SH NAME
globus_rsl_constructors \- RSL Constructors
.SS "Functions"

.in +1c
.ti -1c
.RI "globus_rsl_t * \fBglobus_rsl_make_boolean\fP (int operator, globus_list_t *children)"
.br
.RI "\fIRSL boolean constructor\&. \fP"
.ti -1c
.RI "globus_rsl_t * \fBglobus_rsl_make_relation\fP (int operator, char *attributename, globus_rsl_value_t *value_sequence)"
.br
.RI "\fIRSL relation constructor\&. \fP"
.ti -1c
.RI "globus_rsl_value_t * \fBglobus_rsl_value_make_literal\fP (char *string)"
.br
.RI "\fIRSL literal constructor\&. \fP"
.ti -1c
.RI "globus_rsl_value_t * \fBglobus_rsl_value_make_sequence\fP (globus_list_t *value_list)"
.br
.RI "\fIRSL value sequence constructor\&. \fP"
.ti -1c
.RI "globus_rsl_value_t * \fBglobus_rsl_value_make_variable\fP (globus_rsl_value_t *sequence)"
.br
.RI "\fIRSL variable reference constructor\&. \fP"
.ti -1c
.RI "globus_rsl_value_t * \fBglobus_rsl_value_make_concatenation\fP (globus_rsl_value_t *left_value, globus_rsl_value_t *right_value)"
.br
.RI "\fIRSL concatenation constructor\&. \fP"
.in -1c
.SH "Detailed Description"
.PP 

.SH "Function Documentation"
.PP 
.SS "globus_rsl_t* globus_rsl_make_boolean (int operator, globus_list_t * children)"

.PP
RSL boolean constructor\&. The \fBglobus_rsl_make_boolean()\fP function creates a boolean composition of the RSL nodes in the list pointed to by \fIchildren\fP\&. The new RSL node which is returned contains a reference to the list, not a copy\&.
.PP
\fBParameters:\fP
.RS 4
\fIoperator\fP The boolean RSL operator to use to join the RSL parse tree list pointed to by the \fIchildren\fP parameter\&. This value must be one of GLOBUS_RSL_AND, GLOBUS_RSL_OR, GLOBUS_RSL_MULTIREQ in order to create a valid RSL tree\&. 
.br
\fIchildren\fP Pointer to a list of RSL syntax trees to combine with the boolean operation described by the \fIoperator\fP parameter\&.
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBglobus_rsl_make_boolean()\fP function returns a new RSL parse tree node that contains a shallow reference to the list of values pointed to by the \fIchildren\fP parameter joined by the operator value in the \fIoperator\fP parameter\&. If an error occurs, \fBglobus_rsl_make_boolean()\fP returns NULL\&. 
.RE
.PP

.SS "globus_rsl_t* globus_rsl_make_relation (int operator, char * attributename, globus_rsl_value_t * value_sequence)"

.PP
RSL relation constructor\&. The \fBglobus_rsl_make_relation()\fP function creates a relation between the attribute named by the \fIattributename\fP parameter and the values pointed to by the \fIvalue_sequence\fP list\&. The new RSL relation node which is returned contains a reference to the \fIattributename\fP and \fIvalue_sequence\fP parameters, not a copy\&.
.PP
\fBParameters:\fP
.RS 4
\fIoperator\fP The RSL operator to use to relate the RSL attribute name pointed to by the \fIattributename\fP parameter and the values pointed to by the \fIvalue_sequence\fP parameter\&. This value must be one of GLOBUS_RSL_EQ, GLOBUS_RSL_NEQ, GLOBUS_RSL_GT, GLOBUS_RSL_GTEQ, GLOBUS_RSL_LT, or GLOBUS_RSL_LTEQ in order to create a valid RSL node\&. 
.br
\fIattributename\fP Pointer to a string naming the attribute of the new RSL relation\&. 
.br
\fIvalue_sequence\fP Pointer to a sequence of RSL values to use in the new RSL relation\&.
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBglobus_rsl_make_relation()\fP function returns a new RSL parse tree node that contains a shallow reference to the attribute name pointed to by the \fIattributename\fP parameter and the RSL value sequence pointed to by the \fIvalue_sequence\fP parameter\&. If an error occurs, \fBglobus_rsl_make_relation()\fP returns NULL\&. 
.RE
.PP

.SS "globus_rsl_value_t* globus_rsl_value_make_concatenation (globus_rsl_value_t * left_value, globus_rsl_value_t * right_value)"

.PP
RSL concatenation constructor\&. The \fBglobus_rsl_value_make_concatenation()\fP function creates a concatenation of the values pointed to by the \fIleft_value\fP and \fIright_value\fP parameters\&. The new node returned by this function contains a reference to these parameters' values, not a copy\&.
.PP
\fBParameters:\fP
.RS 4
\fIleft_value\fP A pointer to a RSL value to act as the left side of the concatenation\&. This must be a string literal or variable reference\&. 
.br
\fIright_value\fP A pointer to a RSL value to act as the right side of the concatenation\&. This must be a string literal or variable reference\&.
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBglobus_rsl_value_make_concatenation()\fP function returns a new RSL value node that contains a shallow reference to the values pointed to by the \fIleft_value\fP and \fIright_value\fP parameters\&. If an error occurs, \fBglobus_rsl_value_make_concatenation()\fP returns NULL\&. 
.RE
.PP

.SS "globus_rsl_value_t* globus_rsl_value_make_literal (char * string)"

.PP
RSL literal constructor\&. The \fBglobus_rsl_value_make_literal()\fP function creates a string literal RSL value node containing the value pointed to by the \fIstring\fP parameter\&. The new RSL value node which is returned contains a reference to the \fIstring\fP parameter, not a copy\&.
.PP
\fBParameters:\fP
.RS 4
\fIstring\fP The literal string to be used in the new value\&.
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBglobus_rsl_value_make_literal()\fP function returns a new RSL value node that contains a shallow reference to the string pointed to by the \fIstring\fP parameter\&. If an error occurs, \fBglobus_rsl_value_make_literal()\fP returns NULL\&. 
.RE
.PP

.SS "globus_rsl_value_t* globus_rsl_value_make_sequence (globus_list_t * value_list)"

.PP
RSL value sequence constructor\&. The \fBglobus_rsl_value_make_sequence()\fP function creates a value sequence RSL node referring to the values pointed to by the \fIvalue_list\fP parameter\&. The new node returned by this function contains a reference to the \fIvalue_list\fP parameter, not a copy\&.
.PP
\fBParameters:\fP
.RS 4
\fIvalue_list\fP A pointer to a list of globus_rsl_value_t pointers\&.
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBglobus_rsl_value_make_sequence()\fP function returns a new RSL value node that contains a shallow reference to the list pointed to by the \fIvalue_list\fP parameter\&. If an error occurs, \fBglobus_rsl_value_make_sequence()\fP returns NULL\&. 
.RE
.PP

.SS "globus_rsl_value_t* globus_rsl_value_make_variable (globus_rsl_value_t * sequence)"

.PP
RSL variable reference constructor\&. The \fBglobus_rsl_value_make_variable()\fP function creates a variable reference RSL node referring to the variable name contained in the value pointed to by \fIsequence\fP parameter\&. The new node returned by this function contains a reference to the \fIsequence\fP parameter, not a copy\&.
.PP
\fBParameters:\fP
.RS 4
\fIsequence\fP A pointer to a RSL value sequnce\&.
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBglobus_rsl_value_make_variable()\fP function returns a new RSL value node that contains a shallow reference to the value sequence pointed to by the \fIsequence\fP parameter\&. If an error occurs, \fBglobus_rsl_value_make_variable()\fP returns NULL\&. 
.RE
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for globus_rsl from the source code\&.