# Utility
[OMXMLSecurity]

## Functions
AXIS2_EXTERN axis2_char_t * | oxs_util_generate_nonce (const axutil_env_t *env, int length)
AXIS2_EXTERN axis2_char_t * | oxs_util_generate_id (const axutil_env_t *env, axis2_char_t *prefix)
AXIS2_EXTERN oxs_key_mgr_format_t | oxs_util_get_format_by_file_extension (const axutil_env_t *env, axis2_char_t *file_name)
AXIS2_EXTERN axis2_char_t * | oxs_util_get_newline_removed_string (const axutil_env_t *env, axis2_char_t *input)

## Function Documentation

AXIS2_EXTERN axis2_char_t* oxs_util_generate_id | ( | const axutil_env_t * | env,
|  | axis2_char_t * | prefix |
| ) |  |  |

Generates an id for an element. Specially used in xml encryption and signature references. Caller must free memory

Parameters:

  | env | pointer to environment struct
  | prefix | the prefix of the id. For ex: EncDataID-1u343yrcarwqe

Returns:
  the generated id

AXIS2_EXTERN axis2_char_t* oxs_util_generate_nonce | ( | const axutil_env_t * | env,
|  | int | length |
| ) |  |  |

Generate a nonce or a random text for a given length

Parameters:

  | env | pointer to environment struct
  | length | the length of the nonce

Returns:
  the generated nonce

AXIS2_EXTERN oxs_key_mgr_format_t oxs_util_get_format_by_file_extension | ( | const axutil_env_t * | env,
|  | axis2_char_t * | file_name |
| ) |  |  |

Given the filename returns the format of the file. These formats are defined in asym_ctx.h

Parameters:

  | env | pointer to environment struct
  | file_name | the file name

AXIS2_EXTERN axis2_char_t* oxs_util_get_newline_removed_string | ( | const axutil_env_t * | env,
|  | axis2_char_t * | input |
| ) |  |  |

Given string and returns new lined removed string Caller MUST free memory

Parameters:

  | env | pointer to environment struct
  | input | a pointer to the string which has s. return the newline removed buffer.