awString

void awStringAppend(  
  BrokerString st,  
  char *append);

Appends the source string append to the end of the destination string st.

void awStringAppendByte(  
  BrokerString st,  
  char number);

Appends a string representation of number to the end of the destination string st.

void awStringAppendChar(  
  BrokerString st,  
  char c);

Appends the source character c to the end of the destination string st.

void awStringAppendDouble(  
  BrokerString st,  
  double number);

Appends a string representation of number to the end of the destination string st. The C language locale is used to format the double.

void awStringAppendDoubleLocalized(  
  BrokerString st,  
  double number);

Appends a string representation of number to the end of the destination string st. The current locale is used to format the double.

void awStringAppendFloat(  
  BrokerString st,  
  float number);

Appends a string representation of number to the end of the destination string st. The C language locale is used to format the float.

void awStringAppendFloatLocalized(  
  BrokerString st,  
  float number);

Appends a string representation of number to the end of the destination string st. The current locale is used to format the float.

void awStringAppendInteger(  
  BrokerString st,  
  int number);

Appends a string representation of number to the end of the destination string st.

void awStringAppendLong(  
  BrokerString st,  
  BrokerLong number);

Appends a string representation of number to the end of the destination string st.

void awStringAppendNString(  
  BrokerString st,  
  char *append,  
  int length);

Appends length bytes of the source string append to the end of the destination string st.

void awStringAppendNUCString(  
  BrokerString st,  
  charUC *append,  
  int length);

Appends the specified number of characters from the Unicode source string append to the end of the destination string st.

void awStringAppendShort(  
  BrokerString st,  
  short number);

Appends a string representation of number to the end of the destination string st.

void awStringAppendUC(  
  BrokerString st,  
  charUC c);

Appends the Unicode source character c to the end of the destination string st.

void awStringAppendUCString(  
  BrokerString st,  
  charUC *append);

Appends the specified Unicode source string append to the end of the destination string st.

void awStringClip(  
  BrokerString st,  
  int max_length);

Truncates the string st to the specified max_length. If st already has a length less than or equal to max_length, this function has no effect.

void awStringDecIndent(  
  BrokerString st);

Decrements the string indentation level for st by one level. See awStringIndent for a complete description of the string indentation level.

void awStringIncIndent(BrokerString st);

Increases the string indentation level for st by one. See awStringIndent for a complete description of string indentation level.

void awStringIndent(BrokerString st);

Adds a new line to the string st and then adds a number indentation spaces, based on the current indentation level.

This function may be used with awStringDecIndent and awStringIncIndent as follows:

awStringAppend(st,"Hello");  
awStringIncIndent(st);  
awStringIndent(st);  
awStringAppend(st,"First Indent");  
awStringIncIndent(st);  
awStringIndent(st);  
awStringAppend(st,"Second Indent");  
awStringIndent(st);  
awStringAppend(st,"Still Here");  
awStringDecIndent(st);  
awStringDecIndent(st);  
awStringIndent(st);  
awStringAppend(st,"Back at First Level");

The following output would result from this code:

Hello  
First Indent  
Second Indent  
Still Here  
Back at First Level

int awStringLength(BrokerString st);

Returns the length of the string st.

char * awStringPointer(BrokerString st);

Returns a pointer to the string st.

void awStringResetIndent(BrokerString st);

Resets the string indentation level for st to zero. See awStringIndent for a complete description of string indentation level.