Ice 3.4.2 Source Distributionv3.4.2

1 files changed, 91 insertions, 0 deletions

diff --git a/cpp/include/IceUtil/StringUtil.h b/cpp/include/IceUtil/StringUtil.h
new file mode 100644
index 00000000000..a3d3a87aea8
--- /dev/null
+++ b/cpp/include/IceUtil/StringUtil.h
@@ -0,0 +1,91 @@
+// **********************************************************************
+//
+// Copyright (c) 2003-2011 ZeroC, Inc. All rights reserved.
+//
+// This copy of Ice is licensed to you under the terms described in the
+// ICE_LICENSE file included in this distribution.
+//
+// **********************************************************************
+
+#ifndef ICE_STRING_UTIL_H
+#define ICE_STRING_UTIL_H
+
+#include <IceUtil/Config.h>
+#include <vector>
+
+namespace IceUtilInternal
+{
+
+//
+// Add escape sequences (like "\n", or "\0xxx") to make a string
+// readable in ASCII.
+//
+ICE_UTIL_API std::string escapeString(const std::string&, const std::string&);
+
+//
+// Remove escape sequences added by escapeString. Throws IllegalArgumentException
+// for an invalid input string.
+//
+ICE_UTIL_API std::string unescapeString(const std::string&, std::string::size_type, std::string::size_type);
+
+//
+// Split a string using the given delimiters. Considers single and double quotes;
+// returns false for unbalanced quote, true otherwise.
+//
+ICE_UTIL_API bool splitString(const std::string&, const std::string&, std::vector<std::string>&);
+
+//
+// Join a list of strings using the given delimiter. 
+//
+ICE_UTIL_API std::string joinString(const std::vector<std::string>&, const std::string&);
+
+//
+// Trim white space
+//
+ICE_UTIL_API std::string trim(const std::string&);
+
+//
+// If a single or double quotation mark is found at the start
+// position, then the position of the matching closing quote is
+// returned. If no quotation mark is found at the start position, then
+// 0 is returned. If no matching closing quote is found, then
+// std::string::npos is returned.
+//
+ICE_UTIL_API std::string::size_type checkQuote(const std::string&, std::string::size_type = 0);
+
+//
+// Match `s' against the pattern `pat'. A * in the pattern acts
+// as a wildcard: it matches any non-empty sequence of characters
+// other than a period (`.'). We match by hand here because
+// it's portable across platforms (whereas regex() isn't).
+//
+ICE_UTIL_API bool match(const std::string&, const std::string&, bool = false);
+
+//
+// Get the error message for the last error code or given error code.
+//
+ICE_UTIL_API std::string lastErrorToString();
+#ifdef _WIN32
+ICE_UTIL_API std::string errorToString(int, LPCVOID = NULL);
+#else
+ICE_UTIL_API std::string errorToString(int);
+#endif
+
+//
+// Functions to convert to lower/upper case. These functions accept
+// UTF8 string/characters but ignore non ASCII characters. Unlike, the
+// C methods, these methods are not local dependent.
+//
+ICE_UTIL_API std::string toLower(const std::string&);
+ICE_UTIL_API std::string toUpper(const std::string&);
+ICE_UTIL_API bool isAlpha(char);
+ICE_UTIL_API bool isDigit(char);
+
+//
+// Remove all whitespace from a string
+//
+ICE_UTIL_API std::string removeWhitespace(const std::string&);
+
+}
+
+#endif