NS_CStringContainerInit

« XPCOM API Reference

Summary

The NS_CStringContainerInit function initializes a nsCStringContainer instance for use as a nsACString.

#include "nsStringAPI.h"
 
nsresult NS_CStringContainerInit(
  nsCStringContainer& aString
);

Parameters

aString 
[in] A nsCStringContainer instance to be initialized.

Return Values

The NS_CStringContainerInit function returns NS_OK if successful. Otherwise, it returns an error code.

Remarks

This function is equivalent to NS_CStringContainerInit2(container, nsnull, 0, 0).

The nsCStringContainer structure has private members that should not be accessed directly. After a nsCStringContainer object has been initialized via NS_CStringContainerInit, it may be used as an ordinary nsACString object.

With NS_CStringContainerInit, the coder is required to call NS_CStringContainerFinish when done with the nsCStringContainer object. Therefore, it is generally better to use nsEmbedCString, to instantiate a nsACString object, since it automatically releases allocated memory when the object goes out of scope.

Example

nsCStringContainer str;
if (NS_SUCCEEDED(NS_CStringContainerInit(str)))
{
  // Now, |str| can be used with any function taking a nsACString parameter.
  // Call this function to release any memory owned by |str| when done.
  NS_CStringContainerFinish(str);
}

History

This function was finalized for Mozilla 1.7. See bug 239123 for details.

See Also

NS_CStringContainerFinish, nsACString, nsEmbedCString

Document Tags and Contributors

 Contributors to this page: Sheppy, DarinFisher, Nickolay, Dria
 Last updated by: Sheppy,