---
name: "globus_rsl_assist_string_canonicalize"
section: "3"
platform: "linux"
package: "libglobus-rsl-doc"
version: "11.4-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_rsl_assist"
---

# globus\_rsl\_assist\_string\_canonicalize(3)

RSL Helper Functions - RSL Helper Functions.

Part of [globus\_rsl\_assist(3)](/globus_rsl_assist/3.md).

## NAME

globus\_rsl\_assist - RSL Helper Functions

 \- RSL Helper Functions.

## SYNOPSIS

### Functions

int **globus\_rsl\_assist\_attributes\_canonicalize** (globus\_rsl\_t \*rsl)\
 Canonicalize all attribute names in an RSL parse tree.  void **globus\_rsl\_assist\_string\_canonicalize** (char \*ptr)\
 Canonicalize an attribute name.

## Detailed Description

RSL Helper Functions.

The rsl\_assist library provide a set of functions to canonicalize RSL parse trees or strings.

## Function Documentation

### int globus\_rsl\_assist\_attributes\_canonicalize (globus\_rsl\_t \* rsl)

Canonicalize all attribute names in an RSL parse tree. The **globus\_rsl\_assist\_attributes\_canonicalize()** function performs an in-place canonicalization of the RSL parse tree pointed to by its *rsl* parameter. All relation attribute names will be changed so that they lower-case, with all internal underscore characters removed.

**Parameters**

*rsl* Pointer to the RSL parse tree to canonicalize.

**Returns**

If **globus\_rsl\_assist\_attributes\_canonicalize()** is successful, it will ensure that all attribute names in the given RSL will be in canonical form and return GLOBUS\_SUCCESS. If an error occurs, it will return GLOBUS\_FAILURE.

**Return values**

*GLOBUS\_SUCCESS* Success \
 *GLOBUS\_FAILURE* Failure

### void globus\_rsl\_assist\_string\_canonicalize (char \* ptr)

Canonicalize an attribute name. The **globus\_rsl\_assist\_string\_canonicalize()** function modifies the NULL-terminated string pointed to by its *ptr* parameter so that it is in canonical form. The canonical form is all lower-case with all underscore characters removed.

**Parameters**

*ptr* Pointer to the RSL string to modify in place.

**Returns**

void

## Author

Generated automatically by Doxygen for globus\_rsl from the source code.