(C) Zeriph Enterprises, LLC
omni/types/string_t.hpp
001:
002:
003:
004:
005:
006:
007:
008:
009:
010:
011:
012:
013:
014:
015:
016:
017:
018:
019:
020:
021:
022:
023:
024:
025:
026:
027:
028:
029:
030:
031:
032:
033:
034:
035:
036:
037:
038:
039:
040:
041:
042:
043:
044:
045:
046:
047:
048:
049:
050:
051:
052:
053:
054:
055:
056:
057:
058:
059:
060:
061:
062:
063:
064:
065:
066:
067:
068:
069:
070:
071:
072:
073:
074:
075:
076:
077:
078:
079:
080:
081:
082:
083:
084:
085:
086:
087:
088:
089:
090:
091:
092:
093:
094:
095:
096:
097:
098:
099:
100:
101:
102:
103:
104:
105:
106:
107:
108:
109:
110:
111:
112:
113:
114:
115:
116:
117:
118:
119:
120:
121:
122:
123:
124:
125:
126:
127:
128:
129:
130:
131:
132:
133:
134:
135:
136:
137:
138:
139:
140:
141:
142:
143:
144:
145:
146:
147:
148:
149:
150:
151:
152:
153:
154:
155:
156:
157:
158:
159:
160:
161:
162:
163:
164:
165:
166:
167:
168:
169:
170:
171:
172:
173:
174:
175:
176:
177:
178:
179:
180:
181:
182:
183:
184:
185:
186:
187:
188:
189:
190:
191:
192:
193:
194:
195:
196:
197:
198:
199:
200:
201:
202:
203:
204:
205:
206:
207:
208:
209:
210:
211:
212:
213:
214:
215:
216:
217:
218:
219:
220:
221:
222:
223:
224:
225:
226:
227:
228:
229:
230:
231:
232:
233:
234:
235:
236:
237:
238:
239:
240:
241:
242:
243:
244:
245:
246:
247:
248:
249:
250:
251:
252:
253:
254:
255:
256:
257:
258:
259:
260:
261:
262:
263:
264:
265:
266:
267:
268:
269:
270:
271:
272:
273:
274:
275:
276:
277:
278:
279:
280:
281:
282:
283:
284:
285:
286:
287:
288:
289:
290:
291:
292:
293:
294:
295:
296:
297:
298:










































































































































































































































































































/*
* Copyright (c), Zeriph Enterprises
* All rights reserved.
*
* Contributor(s):
* Zechariah Perez, omni (at) zeriph (dot) com
*
* THIS SOFTWARE IS PROVIDED BY ZERIPH 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 ZERIPH AND 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.
*/
 #if !defined(OMNI_STRING_T_HPP)
#define OMNI_STRING_T_HPP 1
#include <omni/defs/global.hpp>
#include <omni/types/char_t.hpp>
#include <string>
#include <sstream>
// defines the string types to use for different string processing
#if defined(OMNI_UNICODE)
    #define OMNI_STRING_T std::wstring // Defines a wide character string type
    #define OMNI_SSTREAM_T std::wstringstream
    #define OMNI_STR_WIDEN(v) L##v
#else
    #define OMNI_STRING_T std::string // Defines an standard character string type
    #define OMNI_SSTREAM_T std::stringstream
    #define OMNI_STR_WIDEN(v) v
#endif
#if !defined(OMNI_STRW)
    // DEV_NOTE: for a macro that always widens, use OMNI_WSTR (from helper.hpp)
    #define OMNI_STRW(v) OMNI_STR_WIDEN(v)
#endif

namespace omni {
    
    typedef OMNI_STRING_T string_t;
    
    typedef OMNI_SSTREAM_T sstream_t;

    namespace string_util {
        template < typename T >
        inline std::string to_string(const T& val)
        {
            std::stringstream o;
            o << val;
            return o.str();
        }

        inline std::string to_string(bool val)
        {
            return (val ? "true" : "false");
        }

        inline std::string to_string(const std::wstring& str)
        {
            if (str.empty()) { return std::string(); }
            std::size_t sz = str.length();
            #if defined(OMNI_WIN_API)
                std::size_t nd = ::WideCharToMultiByte(CP_UTF8, 0, &str[0], sz, NULL, 0, NULL, NULL);
                if (nd != 0) {
                    std::string cret(static_cast<std::size_t>(nd), '\0');
                    std::size_t w = ::WideCharToMultiByte(CP_UTF8, 0, &str[0], sz, &cret[0], nd, NULL, NULL);
                    if (w != 0) {
                        if (w != sz) {
                            OMNI_ERR_RETV_FW("wrote " << w << " but expected size of " << sz, omni::exceptions::invalid_size(), std::string())
                        }
                        return cret;
                    }
                }
                OMNI_THROW_FW(omni::exceptions::invalid_size())
                return std::string();
            #else
                std::string cret(sz, '\0');
                std::size_t w = std::wcstombs(&cret[0], str.c_str(), sz);
                if (w != 0) {
                    if (w != sz) {
                        OMNI_ERR_RETV_FW("wrote " << w << " but expected size of " << sz, omni::exceptions::invalid_size(), std::string())
                    }
                    return cret;
                }
                OMNI_THROW_FW(omni::exceptions::invalid_size())
                return std::string();
            #endif
        }

        inline std::string to_string(const wchar_t* str)
        {
            if (str) { return omni::string_util::to_string(std::wstring(str)); }
            OMNI_ERR_RETV_FW("Null pointer specified", omni::exceptions::null_pointer_exception(), std::string())
        }

        template < std::size_t X >
        inline std::string to_string(const wchar_t (&str)[X])
        {
            return omni::string_util::to_string(std::wstring(str));
        }

        inline std::string to_string(const char* str)
        {
            if (str) { return std::string(str); }
            OMNI_ERR_RETV_FW("Null pointer specified", omni::exceptions::null_pointer_exception(), std::string())
        }

        template < std::size_t X >
        inline std::string to_string(const char (&str)[X])
        {
            return std::string(str);
        }

        inline std::string to_string(const std::string& str)
        {
            return str;
        }

        template < typename T >
        inline std::wstring to_wstring(const T& val)
        {
            std::wstringstream o;
            o << val;
            return o.str();
        }

        inline std::wstring to_wstring(bool val)
        {
            return (val ? OMNI_WSTR("true") : OMNI_WSTR("false"));
        }

        inline std::wstring to_wstring(const std::string& str)
        {
            if (str.empty()) { return std::wstring(); }
            std::size_t sz = str.length();
            #if defined(OMNI_WIN_API)
                std::size_t nd = ::MultiByteToWideChar(CP_UTF8, 0, &str[0], sz, NULL, 0);
                if (nd != 0) {
                    std::wstring wret(static_cast<std::size_t>(nd), L'\0');
                    std::size_t w = ::MultiByteToWideChar(CP_UTF8, 0, &str[0], sz, &wret[0], nd);
                    if (w != 0) {
                        if (w != sz) {
                            OMNI_ERR_RETV_FW("wrote " << w << " but expected size of " << sz, omni::exceptions::invalid_size(), std::wstring())
                        }
                        return wret;
                    }
                }
                OMNI_THROW_FW(omni::exceptions::invalid_size())
                return std::wstring();
            #else
                std::wstring wret(sz, L'\0');
                std::size_t w = std::mbstowcs(&wret[0], str.c_str(), sz);
                if (w != 0) {
                    if (w != sz) {
                        OMNI_ERR_RETV_FW("wrote " << w << " but expected size of " << sz, omni::exceptions::invalid_size(), std::wstring())
                    }
                    return wret;
                }
                OMNI_THROW_FW(omni::exceptions::invalid_size())
                return std::wstring();
            #endif
        }

        inline std::wstring to_wstring(const char* str)
        {
            if (str) { return omni::string_util::to_wstring(std::string(str)); }
            OMNI_ERR_RETV_FW("Null pointer specified", omni::exceptions::null_pointer_exception(), std::wstring())
        }

        template < std::size_t X >
        inline std::wstring to_wstring(const char (&str)[X])
        {
            return omni::string_util::to_wstring(std::string(str));
        }

        inline std::wstring to_wstring(const wchar_t* str)
        {
            if (str) { return std::wstring(str); }
            OMNI_ERR_RETV_FW("Null pointer specified", omni::exceptions::null_pointer_exception(), std::wstring())
        }

        template < std::size_t X >
        inline std::wstring to_wstring(const wchar_t (&str)[X])
        {
            return std::wstring(str);
        }

        inline std::wstring to_wstring(const std::wstring& str)
        {
            return str;
        }

        template < typename T >
        inline omni::string_t to_string_t(const T& val)
        {
            omni::sstream_t o;
            o << val;
            return o.str();
        }

        inline omni::string_t to_string_t(bool val)
        {
            #if defined(OMNI_UNICODE)
                return (val ? OMNI_WSTR("true") : OMNI_WSTR("false"));
            #else
                return (val ? "true" : "false");
            #endif
        }

        inline omni::string_t to_string_t(const std::wstring& str)
        {
            #if defined(OMNI_UNICODE)
                return str;
            #else
                return omni::string_util::to_string(str);
            #endif
        }

        inline omni::string_t to_string_t(const wchar_t* str)
        {
            if (str) { return omni::string_util::to_string_t(std::wstring(str)); }
            OMNI_ERR_RETV_FW("Null pointer specified", omni::exceptions::null_pointer_exception(), omni::string_t())
        }

        template < std::size_t X >
        inline omni::string_t to_string_t(const wchar_t (&str)[X])
        {
            #if defined(OMNI_UNICODE)
                return std::wstring(str);
            #else
                return omni::string_util::to_string(str);
            #endif
        }

        inline omni::string_t to_string_t(const std::string& str)
        {
            #if defined(OMNI_UNICODE)
                return omni::string_util::to_wstring(str);
            #else
                return str;
            #endif
        }

        inline omni::string_t to_string_t(const char* str)
        {
            if (str) { return omni::string_util::to_string_t(std::string(str)); }
            OMNI_ERR_RETV_FW("Null pointer specified", omni::exceptions::null_pointer_exception(), omni::string_t())
        }

        template < std::size_t X >
        inline omni::string_t to_string_t(const char (&str)[X])
        {
            #if defined(OMNI_UNICODE)
                return omni::string_util::to_wstring(str);
            #else
                return std::string(str);
            #endif
        }
        
        template < typename std_string_t >
        class omni_internal
        {
            public:
                template < typename T >
                static std_string_t lexical_cast(const T& val)
                {
                    return val;
                }
        };

        template <>
        class omni_internal<std::wstring>
        {
            public:
                template < typename T >
                inline static std::wstring lexical_cast(const T& val)
                {
                    return omni::string_util::to_wstring(val);
                }
        };

        template <>
        class omni_internal<std::string>
        {
            public:
                template < typename T >
                inline static std::string lexical_cast(const T& val)
                {
                    return omni::string_util::to_string(val);
                }
        };
    }
}

#endif // OMNI_STRING_T_HPP