string_allocator.h

Go to the documentation of this file.
00001 /*
00002 **  ClanLib SDK
00003 **  Copyright (c) 1997-2011 The ClanLib Team
00004 **
00005 **  This software is provided 'as-is', without any express or implied
00006 **  warranty.  In no event will the authors be held liable for any damages
00007 **  arising from the use of this software.
00008 **
00009 **  Permission is granted to anyone to use this software for any purpose,
00010 **  including commercial applications, and to alter it and redistribute it
00011 **  freely, subject to the following restrictions:
00012 **
00013 **  1. The origin of this software must not be misrepresented; you must not
00014 **     claim that you wrote the original software. If you use this software
00015 **     in a product, an acknowledgment in the product documentation would be
00016 **     appreciated but is not required.
00017 **  2. Altered source versions must be plainly marked as such, and must not be
00018 **     misrepresented as being the original software.
00019 **  3. This notice may not be removed or altered from any source distribution.
00020 **
00021 **  Note: Some of the libraries ClanLib may link to may have additional
00022 **  requirements or restrictions.
00023 **
00024 **  File Author(s):
00025 **
00026 **    Magnus Norddahl
00027 */
00028 
00031 
00032 #pragma once
00033 
00034 #include "../api_core.h"
00035 #include "../System/sharedptr.h"
00036 #include "string_types.h"
00037 
00038 class CL_StringAllocator_Impl;
00039 
00047 class CL_API_CORE CL_StringAllocator
00048 {
00051 
00052 public:
00053         CL_StringAllocator();
00054 
00058         CL_StringAllocator(const CL_StringAllocator &source);
00059 
00060         ~CL_StringAllocator();
00061 
00065 
00066 public:
00067         CL_StringAllocator &operator =(const CL_StringAllocator &source);
00068 
00074         CL_StringRef8 alloc(const CL_StringRef8 &str);
00075 
00081         CL_StringRef8 alloc(const char *str);
00082 
00083         CL_StringRef8 alloc(
00084                 const char *str,
00085                 CL_StringRef8::size_type length);
00086 
00092         CL_StringRef16 alloc(const CL_StringRef16 &str);
00093 
00099         CL_StringRef16 alloc(const wchar_t *str);
00100 
00101         CL_StringRef16 alloc(
00102                 const wchar_t *str,
00103                 CL_StringRef16::size_type length);
00104 
00110         CL_StringRef alloc(unsigned int length);
00111 
00117         CL_StringRef8 alloc8(unsigned int length);
00118 
00124         CL_StringRef16 alloc16(unsigned int length);
00125 
00127         void clear();
00128 
00132 
00133 private:
00134         CL_SharedPtr<CL_StringAllocator_Impl> impl;
00136 };
00137