NS_CStringCloneData

« XPCOM API Reference

Summary

The NS_CStringCloneData function returns a null-terminated, heap allocated copy of the string's internal buffer.

  #include "nsStringAPI.h"
  char* NS_CStringCloneData(
    const nsACString& aString
  );

Parameters

aString

[in] A nsACString instance whose data is to be cloned.

Return Values

The NS_CStringCutData function returns a pointer to a null-terminated, heap allocated buffer on success. On failure it returns nsnull. The resulting buffer may be freed by calling nsMemory::Free.

History

This function was frozen for Mozilla 1.7. See bug 239716 for details.

See Also

nsMemory::Free, nsACString