new string api for embedders / component authors

git-svn-id: svn://10.0.0.236/branches/STRING_20040119_BRANCH@151568 18797224-902f-48f8-a5cc-f745e15eee43

mozilla/xpcom/string/minapi/nsStringAPI.cpp

@@ -0,0 +1,193 @@
+/* vim:set ts=2 sw=2 et cindent: */
+/* ***** BEGIN LICENSE BLOCK *****
+ * Version: MPL 1.1/GPL 2.0/LGPL 2.1
+ *
+ * The contents of this file are subject to the Mozilla Public License Version
+ * 1.1 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ * http://www.mozilla.org/MPL/
+ *
+ * Software distributed under the License is distributed on an "AS IS" basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ *
+ * The Original Code is Mozilla.
+ *
+ * The Initial Developer of the Original Code is IBM Corporation.
+ * Portions created by IBM Corporation are Copyright (C) 2003
+ * IBM Corporation.  All Rights Reserved.
+ *
+ * Contributor(s):
+ *   Darin Fisher <darin@meer.net>
+ *
+ * Alternatively, the contents of this file may be used under the terms of
+ * either the GNU General Public License Version 2 or later (the "GPL"), or
+ * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+ * in which case the provisions of the GPL or the LGPL are applicable instead
+ * of those above. If you wish to allow use of your version of this file only
+ * under the terms of either the GPL or the LGPL, and not to allow others to
+ * use your version of this file under the terms of the MPL, indicate your
+ * decision by deleting the provisions above and replace them with the notice
+ * and other provisions required by the GPL or the LGPL. If you do not delete
+ * the provisions above, a recipient may use your version of this file under
+ * the terms of any one of the MPL, the GPL or the LGPL.
+ *
+ * ***** END LICENSE BLOCK ***** */
+
+#include "nsStringAPI.h"
+#include "nsString.h"
+#include "nsString2.h"
+#include "nsCharTraits.h"
+
+/* ------------------------------------------------------------------------- */
+
+NS_STRINGAPI(PRBool)
+NS_StringContainerInit(nsStringContainer &aContainer)
+{
+  NS_ASSERTION(sizeof(nsStringContainer) >= sizeof(nsString),
+      "nsStringContainer is not large enough");
+
+  // use placement new to avoid heap allocating nsString object
+  new (&aContainer) nsString();
+
+  return PR_TRUE;
+}
+
+NS_STRINGAPI(void)
+NS_StringContainerFinish(nsStringContainer &aContainer)
+{
+  // call the nsString dtor
+  NS_REINTERPRET_CAST(nsString *, &aContainer)->~nsString();
+}
+
+/* ------------------------------------------------------------------------- */
+
+NS_STRINGAPI(PRUint32)
+NS_StringGetLength(const nsAString &aStr)
+{
+  return aStr.Length();
+}
+
+NS_STRINGAPI(const PRUnichar *)
+NS_StringGetDataPtr(const nsAString &aStr)
+{
+  if (aStr.IsTerminated())
+  {
+    const nsAFlatString &flat = NS_STATIC_CAST(const nsAFlatString &, aStr);
+    return flat.get();
+  }
+  return nsnull;
+}
+
+NS_STRINGAPI(PRUint32)
+NS_StringGetData(const nsAString &aStr, PRUnichar *aBuf, PRUint32 aBufLen)
+{
+  nsAString::const_iterator start, end;
+  aStr.BeginReading(start);
+  aStr.EndReading(end);
+  PRUint32 result = Distance(start, end);
+  if (result >= aBufLen)
+  {
+    end = start;
+    end.advance(aBufLen - 1);
+    result = aBufLen - 1;
+  }
+  *copy_string(start, end, aBuf) = PRUnichar(0);
+  return result;
+}
+
+NS_STRINGAPI(void)
+NS_StringSetData(nsAString &aStr, const PRUnichar *aBuf, PRUint32 aCount)
+{
+  if (aCount == PR_UINT32_MAX)
+    aCount = (PRUint32) nsCharTraits<PRUnichar>::length(aBuf);
+
+  aStr.Assign(aBuf, aCount);
+}
+
+NS_STRINGAPI(void)
+NS_StringCopy(nsAString &aDest, const nsAString &aSrc, PRUint32 aOffset,
+              PRUint32 aCount)
+{
+  if (aOffset == 0 && aCount == PR_UINT32_MAX)
+    aDest.Assign(aSrc);
+  else
+    aDest.Assign(Substring(aSrc, aOffset, aCount));
+}
+
+/* ------------------------------------------------------------------------- */
+
+NS_STRINGAPI(PRBool)
+NS_CStringContainerInit(nsCStringContainer &aContainer)
+{
+  NS_ASSERTION(sizeof(nsCStringContainer) >= sizeof(nsCString),
+      "nsCStringContainer is not large enough");
+
+  // use placement new to avoid heap allocating nsCString object
+  new (&aContainer) nsCString();
+
+  return PR_TRUE;
+}
+
+NS_STRINGAPI(void)
+NS_CStringContainerFinish(nsCStringContainer &aContainer)
+{
+  // call the nsCString dtor
+  NS_REINTERPRET_CAST(nsCString *, &aContainer)->~nsCString();
+}
+
+/* ------------------------------------------------------------------------- */
+
+NS_STRINGAPI(PRUint32)
+NS_CStringGetLength(const nsACString &aStr)
+{
+  return aStr.Length();
+}
+
+NS_STRINGAPI(const char *)
+NS_CStringGetDataPtr(const nsACString &aStr)
+{
+  if (aStr.IsTerminated())
+  {
+    const nsAFlatCString &flat = NS_STATIC_CAST(const nsAFlatCString &, aStr);
+    return flat.get();
+  }
+  return nsnull;
+}
+
+NS_STRINGAPI(PRUint32)
+NS_CStringGetData(const nsACString &aStr, char *aBuf, PRUint32 aBufLen)
+{
+  nsACString::const_iterator start, end;
+  aStr.BeginReading(start);
+  aStr.EndReading(end);
+  PRUint32 result = Distance(start, end);
+  if (result >= aBufLen)
+  {
+    end = start;
+    end.advance(aBufLen - 1);
+    result = aBufLen - 1;
+  }
+  *copy_string(start, end, aBuf) = char(0);
+  return result;
+}
+
+NS_STRINGAPI(void)
+NS_CStringSetData(nsACString &aStr, const char *aBuf, PRUint32 aCount)
+{
+  if (aCount == PR_UINT32_MAX)
+    aCount = (PRUint32) nsCharTraits<char>::length(aBuf);
+
+  aStr.Assign(aBuf, aCount);
+}
+
+NS_STRINGAPI(void)
+NS_CStringCopy(nsACString &aDest, const nsACString &aSrc, PRUint32 aOffset,
+               PRUint32 aCount)
+{
+  if (aOffset == 0 && aCount == PR_UINT32_MAX)
+    aDest.Assign(aSrc);
+  else
+    aDest.Assign(Substring(aSrc, aOffset, aCount));
+}