2017-06-29 12:18:14 +02:00
|
|
|
/*
|
|
|
|
* Copyright 2016 Two Blue Cubes Ltd. All rights reserved.
|
|
|
|
*
|
|
|
|
* Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
|
|
* file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
*/
|
|
|
|
#ifndef CATCH_STRINGREF_H_INCLUDED
|
|
|
|
#define CATCH_STRINGREF_H_INCLUDED
|
|
|
|
|
2017-08-05 23:53:21 +02:00
|
|
|
#include <cstddef>
|
2017-08-14 09:39:14 +02:00
|
|
|
#include <string>
|
2017-08-14 09:50:44 +02:00
|
|
|
#include <iosfwd>
|
2017-08-05 23:53:21 +02:00
|
|
|
|
2017-06-29 12:18:14 +02:00
|
|
|
namespace Catch {
|
|
|
|
|
|
|
|
class StringData;
|
|
|
|
|
|
|
|
/// A non-owning string class (similar to the forthcoming std::string_view)
|
|
|
|
/// Note that, because a StringRef may be a substring of another string,
|
|
|
|
/// it may not be null terminated. c_str() must return a null terminated
|
|
|
|
/// string, however, and so the StringRef will internally take ownership
|
|
|
|
/// (taking a copy), if necessary. In theory this ownership is not externally
|
|
|
|
/// visible - but it does mean (substring) StringRefs should not be shared between
|
|
|
|
/// threads.
|
|
|
|
class StringRef {
|
2017-11-21 12:08:08 +01:00
|
|
|
public:
|
|
|
|
using size_type = std::size_t;
|
|
|
|
|
|
|
|
private:
|
2017-06-29 12:18:14 +02:00
|
|
|
friend struct StringRefTestAccess;
|
|
|
|
|
|
|
|
char const* m_start;
|
|
|
|
size_type m_size;
|
|
|
|
|
2017-08-14 10:14:49 +02:00
|
|
|
char* m_data = nullptr;
|
2017-06-29 12:18:14 +02:00
|
|
|
|
|
|
|
void takeOwnership();
|
2017-11-17 19:33:34 +01:00
|
|
|
|
|
|
|
static constexpr char const* const s_empty = "";
|
2017-06-29 12:18:14 +02:00
|
|
|
|
|
|
|
public: // construction/ assignment
|
2017-11-17 19:33:34 +01:00
|
|
|
StringRef() noexcept
|
|
|
|
: StringRef( s_empty, 0 )
|
|
|
|
{}
|
|
|
|
|
|
|
|
StringRef( StringRef const& other ) noexcept
|
|
|
|
: m_start( other.m_start ),
|
|
|
|
m_size( other.m_size )
|
|
|
|
{}
|
|
|
|
|
|
|
|
StringRef( StringRef&& other ) noexcept
|
|
|
|
: m_start( other.m_start ),
|
|
|
|
m_size( other.m_size ),
|
|
|
|
m_data( other.m_data )
|
|
|
|
{
|
|
|
|
other.m_data = nullptr;
|
|
|
|
}
|
|
|
|
|
2017-11-21 12:08:08 +01:00
|
|
|
StringRef( char const* rawChars ) noexcept;
|
2017-11-17 19:33:34 +01:00
|
|
|
|
|
|
|
StringRef( char const* rawChars, size_type size ) noexcept
|
|
|
|
: m_start( rawChars ),
|
|
|
|
m_size( size )
|
|
|
|
{}
|
|
|
|
|
|
|
|
StringRef( std::string const& stdString ) noexcept
|
|
|
|
: m_start( stdString.c_str() ),
|
|
|
|
m_size( stdString.size() )
|
|
|
|
{}
|
|
|
|
|
|
|
|
~StringRef() noexcept {
|
|
|
|
delete[] m_data;
|
|
|
|
}
|
|
|
|
|
2017-11-17 21:15:26 +01:00
|
|
|
auto operator = ( StringRef const &other ) noexcept -> StringRef& {
|
|
|
|
delete[] m_data;
|
|
|
|
m_data = nullptr;
|
|
|
|
m_start = other.m_start;
|
|
|
|
m_size = other.m_size;
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
2017-08-14 09:39:14 +02:00
|
|
|
operator std::string() const;
|
2017-06-29 12:18:14 +02:00
|
|
|
|
|
|
|
void swap( StringRef& other ) noexcept;
|
|
|
|
|
|
|
|
public: // operators
|
|
|
|
auto operator == ( StringRef const& other ) const noexcept -> bool;
|
|
|
|
auto operator != ( StringRef const& other ) const noexcept -> bool;
|
|
|
|
|
2017-07-27 10:46:18 +02:00
|
|
|
auto operator[] ( size_type index ) const noexcept -> char;
|
2017-06-29 12:18:14 +02:00
|
|
|
|
|
|
|
public: // named queries
|
2017-11-17 19:33:34 +01:00
|
|
|
auto empty() const noexcept -> bool {
|
|
|
|
return m_size == 0;
|
|
|
|
}
|
|
|
|
auto size() const noexcept -> size_type {
|
|
|
|
return m_size;
|
|
|
|
}
|
|
|
|
|
2017-08-05 22:41:56 +02:00
|
|
|
auto numberOfCharacters() const noexcept -> size_type;
|
2017-06-29 12:18:14 +02:00
|
|
|
auto c_str() const -> char const*;
|
|
|
|
|
|
|
|
public: // substrings and searches
|
|
|
|
auto substr( size_type start, size_type size ) const noexcept -> StringRef;
|
|
|
|
|
|
|
|
private: // ownership queries - may not be consistent between calls
|
|
|
|
auto isOwned() const noexcept -> bool;
|
|
|
|
auto isSubstring() const noexcept -> bool;
|
|
|
|
auto data() const noexcept -> char const*;
|
|
|
|
};
|
|
|
|
|
2017-08-14 10:04:14 +02:00
|
|
|
auto operator + ( StringRef const& lhs, StringRef const& rhs ) -> std::string;
|
|
|
|
auto operator + ( StringRef const& lhs, char const* rhs ) -> std::string;
|
|
|
|
auto operator + ( char const* lhs, StringRef const& rhs ) -> std::string;
|
2017-08-14 09:50:44 +02:00
|
|
|
|
|
|
|
auto operator << ( std::ostream& os, StringRef const& sr ) -> std::ostream&;
|
|
|
|
|
2017-11-21 12:08:08 +01:00
|
|
|
inline auto operator ""_sr( char const* rawChars, std::size_t size ) noexcept -> StringRef {
|
|
|
|
return StringRef( rawChars, size );
|
|
|
|
}
|
|
|
|
|
2017-06-29 12:18:14 +02:00
|
|
|
} // namespace Catch
|
|
|
|
|
|
|
|
#endif // CATCH_STRINGREF_H_INCLUDED
|