Index: sdch/open_vcdiff/depot/opensource/open-vcdiff/src/gtest/internal/gtest-string.h |
=================================================================== |
--- sdch/open_vcdiff/depot/opensource/open-vcdiff/src/gtest/internal/gtest-string.h (revision 2678) |
+++ sdch/open_vcdiff/depot/opensource/open-vcdiff/src/gtest/internal/gtest-string.h (working copy) |
@@ -1,268 +0,0 @@ |
-// Copyright 2005, Google Inc. |
-// All rights reserved. |
-// |
-// Redistribution and use in source and binary forms, with or without |
-// modification, are permitted provided that the following conditions are |
-// met: |
-// |
-// * Redistributions of source code must retain the above copyright |
-// notice, this list of conditions and the following disclaimer. |
-// * Redistributions in binary form must reproduce the above |
-// copyright notice, this list of conditions and the following disclaimer |
-// in the documentation and/or other materials provided with the |
-// distribution. |
-// * Neither the name of Google Inc. nor the names of its |
-// contributors may be used to endorse or promote products derived from |
-// this software without specific prior written permission. |
-// |
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
-// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
-// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
-// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
-// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
-// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
-// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
-// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
-// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
-// |
-// Authors: wan@google.com (Zhanyong Wan), eefacm@gmail.com (Sean Mcafee) |
-// |
-// The Google C++ Testing Framework (Google Test) |
-// |
-// This header file declares the String class and functions used internally by |
-// Google Test. They are subject to change without notice. They should not used |
-// by code external to Google Test. |
-// |
-// This header file is #included by testing/base/internal/gtest-internal.h. |
-// It should not be #included by other files. |
- |
-#ifndef GTEST_INCLUDE_GTEST_INTERNAL_GTEST_STRING_H_ |
-#define GTEST_INCLUDE_GTEST_INTERNAL_GTEST_STRING_H_ |
- |
-#include <string.h> |
-#include <gtest/internal/gtest-port.h> |
- |
-namespace testing { |
-namespace internal { |
- |
-// String - a UTF-8 string class. |
-// |
-// We cannot use std::string as Microsoft's STL implementation in |
-// Visual C++ 7.1 has problems when exception is disabled. There is a |
-// hack to work around this, but we've seen cases where the hack fails |
-// to work. |
-// |
-// Also, String is different from std::string in that it can represent |
-// both NULL and the empty string, while std::string cannot represent |
-// NULL. |
-// |
-// NULL and the empty string are considered different. NULL is less |
-// than anything (including the empty string) except itself. |
-// |
-// This class only provides minimum functionality necessary for |
-// implementing Google Test. We do not intend to implement a full-fledged |
-// string class here. |
-// |
-// Since the purpose of this class is to provide a substitute for |
-// std::string on platforms where it cannot be used, we define a copy |
-// constructor and assignment operators such that we don't need |
-// conditional compilation in a lot of places. |
-// |
-// In order to make the representation efficient, the d'tor of String |
-// is not virtual. Therefore DO NOT INHERIT FROM String. |
-class String { |
- public: |
- // Static utility methods |
- |
- // Returns the input if it's not NULL, otherwise returns "(null)". |
- // This function serves two purposes: |
- // |
- // 1. ShowCString(NULL) has type 'const char *', instead of the |
- // type of NULL (which is int). |
- // |
- // 2. In MSVC, streaming a null char pointer to StrStream generates |
- // an access violation, so we need to convert NULL to "(null)" |
- // before streaming it. |
- static inline const char* ShowCString(const char* c_str) { |
- return c_str ? c_str : "(null)"; |
- } |
- |
- // Returns the input enclosed in double quotes if it's not NULL; |
- // otherwise returns "(null)". For example, "\"Hello\"" is returned |
- // for input "Hello". |
- // |
- // This is useful for printing a C string in the syntax of a literal. |
- // |
- // Known issue: escape sequences are not handled yet. |
- static String ShowCStringQuoted(const char* c_str); |
- |
- // Clones a 0-terminated C string, allocating memory using new. The |
- // caller is responsible for deleting the return value using |
- // delete[]. Returns the cloned string, or NULL if the input is |
- // NULL. |
- // |
- // This is different from strdup() in string.h, which allocates |
- // memory using malloc(). |
- static const char* CloneCString(const char* c_str); |
- |
- // Compares two C strings. Returns true iff they have the same content. |
- // |
- // Unlike strcmp(), this function can handle NULL argument(s). A |
- // NULL C string is considered different to any non-NULL C string, |
- // including the empty string. |
- static bool CStringEquals(const char* lhs, const char* rhs); |
- |
- // Converts a wide C string to a String using the UTF-8 encoding. |
- // NULL will be converted to "(null)". If an error occurred during |
- // the conversion, "(failed to convert from wide string)" is |
- // returned. |
- static String ShowWideCString(const wchar_t* wide_c_str); |
- |
- // Similar to ShowWideCString(), except that this function encloses |
- // the converted string in double quotes. |
- static String ShowWideCStringQuoted(const wchar_t* wide_c_str); |
- |
- // Compares two wide C strings. Returns true iff they have the same |
- // content. |
- // |
- // Unlike wcscmp(), this function can handle NULL argument(s). A |
- // NULL C string is considered different to any non-NULL C string, |
- // including the empty string. |
- static bool WideCStringEquals(const wchar_t* lhs, const wchar_t* rhs); |
- |
- // Compares two C strings, ignoring case. Returns true iff they |
- // have the same content. |
- // |
- // Unlike strcasecmp(), this function can handle NULL argument(s). |
- // A NULL C string is considered different to any non-NULL C string, |
- // including the empty string. |
- static bool CaseInsensitiveCStringEquals(const char* lhs, |
- const char* rhs); |
- |
- // Formats a list of arguments to a String, using the same format |
- // spec string as for printf. |
- // |
- // We do not use the StringPrintf class as it is not universally |
- // available. |
- // |
- // The result is limited to 4096 characters (including the tailing |
- // 0). If 4096 characters are not enough to format the input, |
- // "<buffer exceeded>" is returned. |
- static String Format(const char* format, ...); |
- |
- // C'tors |
- |
- // The default c'tor constructs a NULL string. |
- String() : c_str_(NULL) {} |
- |
- // Constructs a String by cloning a 0-terminated C string. |
- String(const char* c_str) : c_str_(NULL) { // NOLINT |
- *this = c_str; |
- } |
- |
- // Constructs a String by copying a given number of chars from a |
- // buffer. E.g. String("hello", 3) will create the string "hel". |
- String(const char* buffer, size_t len); |
- |
- // The copy c'tor creates a new copy of the string. The two |
- // String objects do not share content. |
- String(const String& str) : c_str_(NULL) { |
- *this = str; |
- } |
- |
- // D'tor. String is intended to be a final class, so the d'tor |
- // doesn't need to be virtual. |
- ~String() { delete[] c_str_; } |
- |
- // Returns true iff this is an empty string (i.e. ""). |
- bool empty() const { |
- return (c_str_ != NULL) && (*c_str_ == '\0'); |
- } |
- |
- // Compares this with another String. |
- // Returns < 0 if this is less than rhs, 0 if this is equal to rhs, or > 0 |
- // if this is greater than rhs. |
- int Compare(const String& rhs) const; |
- |
- // Returns true iff this String equals the given C string. A NULL |
- // string and a non-NULL string are considered not equal. |
- bool operator==(const char* c_str) const { |
- return CStringEquals(c_str_, c_str); |
- } |
- |
- // Returns true iff this String doesn't equal the given C string. A NULL |
- // string and a non-NULL string are considered not equal. |
- bool operator!=(const char* c_str) const { |
- return !CStringEquals(c_str_, c_str); |
- } |
- |
- // Returns true iff this String ends with the given suffix. *Any* |
- // String is considered to end with a NULL or empty suffix. |
- bool EndsWith(const char* suffix) const; |
- |
- // Returns true iff this String ends with the given suffix, not considering |
- // case. Any String is considered to end with a NULL or empty suffix. |
- bool EndsWithCaseInsensitive(const char* suffix) const; |
- |
- // Returns the length of the encapsulated string, or -1 if the |
- // string is NULL. |
- int GetLength() const { |
- return c_str_ ? static_cast<int>(strlen(c_str_)) : -1; |
- } |
- |
- // Gets the 0-terminated C string this String object represents. |
- // The String object still owns the string. Therefore the caller |
- // should NOT delete the return value. |
- const char* c_str() const { return c_str_; } |
- |
- // Sets the 0-terminated C string this String object represents. |
- // The old string in this object is deleted, and this object will |
- // own a clone of the input string. This function copies only up to |
- // length bytes (plus a terminating null byte), or until the first |
- // null byte, whichever comes first. |
- // |
- // This function works even when the c_str parameter has the same |
- // value as that of the c_str_ field. |
- void Set(const char* c_str, size_t length); |
- |
- // Assigns a C string to this object. Self-assignment works. |
- const String& operator=(const char* c_str); |
- |
- // Assigns a String object to this object. Self-assignment works. |
- const String& operator=(const String &rhs) { |
- *this = rhs.c_str_; |
- return *this; |
- } |
- |
- private: |
- const char* c_str_; |
-}; |
- |
-// Streams a String to an ostream. |
-inline ::std::ostream& operator <<(::std::ostream& os, const String& str) { |
- // We call String::ShowCString() to convert NULL to "(null)". |
- // Otherwise we'll get an access violation on Windows. |
- return os << String::ShowCString(str.c_str()); |
-} |
- |
-// Gets the content of the StrStream's buffer as a String. Each '\0' |
-// character in the buffer is replaced with "\\0". |
-String StrStreamToString(StrStream* stream); |
- |
-// Converts a streamable value to a String. A NULL pointer is |
-// converted to "(null)". When the input value is a ::string, |
-// ::std::string, ::wstring, or ::std::wstring object, each NUL |
-// character in it is replaced with "\\0". |
- |
-// Declared here but defined in gtest.h, so that it has access |
-// to the definition of the Message class, required by the ARM |
-// compiler. |
-template <typename T> |
-String StreamableToString(const T& streamable); |
- |
-} // namespace internal |
-} // namespace testing |
- |
-#endif // GTEST_INCLUDE_GTEST_INTERNAL_GTEST_STRING_H_ |