<<O>>  Difference Topic GulString (r1.1 - 18 Dec 2004 - CrispinFlowerday)
Line: 1 to 1
META TOPICINFO CrispinFlowerday date="1103412382" format="1.0" version="1.1"

Mozilla String Handling

Mozilla used to have a wide range of string classes, which didn't provide a stable ABI. In mozilla 1.7 them implemented a couple of classes called nsEmbedString and nsEmbedCString. These are thin wrappers around a C like interface to provide a stable API/ABI. These interfaces are frozen.

In mozilla 1.8 there are more thin wrappers around the stable API to provide compatibility with the internal string classes (things like nsAutoString, nsDependentSubstring and NS_ConvertUTF16toUTF8). Unfortunately we can't use these as Galeon only supports mozilla 1.7.

Although the nsEmbedString API provides us with a useable interface, there is no easy way to convert from UTF16 <-> UTF8. To make it easy to perform the conversion, and provide a consistent and simple API, Galeon has a few string classes of its own that are compatible with the mozilla classes:

  • GulString - A container for UTF16 strings (wrapper around nsEmbedString)
  • GulCString - A container for UTF8 strings (wrapper around nsEmbedCString)
  • GulDependantString - Wrap a string object around a const PRUnichar*
  • GulDependantCString - Wrap a string object around a const char*

GulString and GulCString perform automatic conversion from UTF8 and UTF16 repsectively. They also provide some convenience functions that aren't available in the nsEmbedString API (such as IsEmpty() and Equals()).

The GulDependantString classes just wrap their argument in a string object, so that they can be passed to functions that expect an nsAString (or nsACString) input.

NS_LITERAL_STRING() wraps a literal (i.e. double quoted string) in a mozilla string class, it might be implemented as GulString or a proper mozilla class depending on the version of mozilla being compiled against, either way, you should NOT use variables inside the macro.


If you used to use this Use this instead Description
nsAutoString GulString Container for a UTF16 string
nsCAutoString GulCString Container for a UTF8 string
NS_LITERAL_STRING NS_LITERAL_STRING Wrapper around a literal string
nsDependentString GulDependentString Wrapper around a const PRUnichar*
nsDependentCString GulDependentCString Wrapper around a const char *
NS_ConvertUCS2toUTF8 GulCString Convert from UTF16 to UTF8, this is now done automatically
NS_ConvertUTF8toUCS2 GulString Convert from UTF8 to UTF16, this is now done automatically
nsXPIDLString PRUnichar* / nsMemory::Free You need to do this manually now

Revision -
Revision r1.1 - 18 Dec 2004 - 23:26 - CrispinFlowerday
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Galeon? Send feedback.