[AXIS2C-1443] axutil_string_create_const() has a strange signature

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Won't Fix
• Affects Version/s: 1.6.0
• Component/s: util
• Assignee: Unassigned
• Reporter: Olivier Mengué
• Created: 29/Jan/10 18:00
• Updated: 07/Apr/20 17:45
• Resolved: 04/Mar/10 14:44

Description

axutil_string_create_const() has a strange signature:

/**

• Creates a string struct.
• @param str pointer to string. string struct would not create a duplicate
• of this and assumes the str would have longer life than that of itself
• @param env pointer to environment struct
• @return a pointer to newly created string struct
  */
  AXIS2_EXTERN axutil_string_t *AXIS2_CALL
  axutil_string_create_const(
  const axutil_env_t * env,
  axis2_char_t ** str);

Why "** str" and not "* str" ?

I expected to be able to do:
axutil_string_t *soap_action = axutil_string_create_const(env, "MySoapAction");

Instead I have to do:
const axis2_char_t * MySoapAction = "MySoapAction"
axutil_string_t *soap_action = axutil_string_create_const(env, &MySoapAction);

This is crazy !

Same problem for axutil_string_create_assume_ownership().