Chris@16: // Copyright David Abrahams 2002.
Chris@16: // Distributed under the Boost Software License, Version 1.0. (See
Chris@16: // accompanying file LICENSE_1_0.txt or copy at
Chris@16: // http://www.boost.org/LICENSE_1_0.txt)
Chris@16: #ifndef STR_20020703_HPP
Chris@16: #define STR_20020703_HPP
Chris@16: 
Chris@16: # include <boost/python/detail/prefix.hpp>
Chris@16: 
Chris@16: #include <boost/python/object.hpp>
Chris@16: #include <boost/python/list.hpp>
Chris@16: #include <boost/python/converter/pytype_object_mgr_traits.hpp>
Chris@16: 
Chris@16: // disable defines in <cctype> provided by some system libraries
Chris@16: #undef isspace
Chris@16: #undef islower
Chris@16: #undef isalpha
Chris@16: #undef isdigit
Chris@16: #undef isalnum
Chris@16: #undef isupper
Chris@16: 
Chris@16: namespace boost { namespace python {
Chris@16: 
Chris@16: class str;
Chris@16: 
Chris@16: namespace detail
Chris@16: {
Chris@16:   struct BOOST_PYTHON_DECL str_base : object
Chris@16:   {
Chris@16:       str capitalize() const;
Chris@16: 
Chris@16:       str center(object_cref width) const;
Chris@16: 
Chris@16:       long count(object_cref sub) const;
Chris@16: 
Chris@16:       long count(object_cref sub, object_cref start) const;
Chris@16:     
Chris@16:       long count(object_cref sub, object_cref start, object_cref end) const;
Chris@16: 
Chris@16: #if PY_VERSION_HEX < 0x03000000
Chris@16:       object decode() const;
Chris@16:       object decode(object_cref encoding) const;
Chris@16: 
Chris@16:       object decode(object_cref encoding, object_cref errors) const;
Chris@16: #endif
Chris@16: 
Chris@16:       object encode() const;
Chris@16:       object encode(object_cref encoding) const;
Chris@16:       object encode(object_cref encoding, object_cref errors) const;
Chris@16: 
Chris@16:       bool endswith(object_cref suffix) const;
Chris@16:     
Chris@16:       bool endswith(object_cref suffix, object_cref start) const;
Chris@16:       bool endswith(object_cref suffix, object_cref start, object_cref end) const;
Chris@16:     
Chris@16:       str expandtabs() const;
Chris@16:       str expandtabs(object_cref tabsize) const;
Chris@16: 
Chris@16:       long find(object_cref sub) const;
Chris@16:       long find(object_cref sub, object_cref start) const;
Chris@16: 
Chris@16:       long find(object_cref sub, object_cref start, object_cref end) const;
Chris@16: 
Chris@16:       long index(object_cref sub) const;
Chris@16: 
Chris@16:       long index(object_cref sub, object_cref start) const;
Chris@16:       long index(object_cref sub, object_cref start, object_cref end) const;
Chris@16: 
Chris@16:       bool isalnum() const;
Chris@16:       bool isalpha() const;
Chris@16:       bool isdigit() const;
Chris@16:       bool islower() const;
Chris@16:       bool isspace() const;
Chris@16:       bool istitle() const;
Chris@16:       bool isupper() const;
Chris@16:     
Chris@16:       str join(object_cref sequence) const;
Chris@16: 
Chris@16:       str ljust(object_cref width) const;
Chris@16:       str lower() const;
Chris@16:       str lstrip() const;
Chris@16: 
Chris@16:       str replace(object_cref old, object_cref new_) const;
Chris@16:       str replace(object_cref old, object_cref new_, object_cref maxsplit) const;
Chris@16:       long rfind(object_cref sub) const;
Chris@16: 
Chris@16:       long rfind(object_cref sub, object_cref start) const;
Chris@16: 
Chris@16:       long rfind(object_cref sub, object_cref start, object_cref end) const;
Chris@16:       long rindex(object_cref sub) const;
Chris@16:       long rindex(object_cref sub, object_cref start) const;
Chris@16: 
Chris@16: 
Chris@16:       long rindex(object_cref sub, object_cref start, object_cref end) const;
Chris@16: 
Chris@16:       str rjust(object_cref width) const;
Chris@16:     
Chris@16:       str rstrip() const;
Chris@16:     
Chris@16:       list split() const; 
Chris@16:       list split(object_cref sep) const;
Chris@16:    
Chris@16:       list split(object_cref sep, object_cref maxsplit) const; 
Chris@16:     
Chris@16: 
Chris@16:       list splitlines() const;
Chris@16:       list splitlines(object_cref keepends) const;
Chris@16: 
Chris@16:       bool startswith(object_cref prefix) const;
Chris@16: 
Chris@16: 
Chris@16:       bool startswith(object_cref prefix, object_cref start) const;
Chris@16:       bool startswith(object_cref prefix, object_cref start, object_cref end) const;
Chris@16: 
Chris@16:       str strip() const;
Chris@16:       str swapcase() const;
Chris@16:       str title() const;
Chris@16:     
Chris@16:       str translate(object_cref table) const;
Chris@16: 
Chris@16:       str translate(object_cref table, object_cref deletechars) const;
Chris@16: 
Chris@16:     
Chris@16:       str upper() const;
Chris@16: 
Chris@16:    protected:
Chris@16:       str_base(); // new str
Chris@16:     
Chris@16:       str_base(const char* s); // new str
Chris@16: 
Chris@16:       str_base(char const* start, char const* finish);
Chris@16:       
Chris@16:       str_base(char const* start, std::size_t length);
Chris@16:       
Chris@16:       explicit str_base(object_cref other);
Chris@16: 
Chris@16:       BOOST_PYTHON_FORWARD_OBJECT_CONSTRUCTORS(str_base, object)
Chris@16:    private:
Chris@16:       static new_reference call(object const&);
Chris@16:   };
Chris@16: }
Chris@16: 
Chris@16: 
Chris@16: class str : public detail::str_base
Chris@16: {
Chris@16:     typedef detail::str_base base;
Chris@16:  public:
Chris@16:     str() {} // new str
Chris@16:     
Chris@16:     str(const char* s) : base(s) {} // new str
Chris@16:     
Chris@16:     str(char const* start, char const* finish) // new str
Chris@16:       : base(start, finish)
Chris@16:     {}
Chris@16:     
Chris@16:     str(char const* start, std::size_t length) // new str
Chris@16:       : base(start, length)
Chris@16:     {}
Chris@16:     
Chris@16:     template <class T>
Chris@16:     explicit str(T const& other)
Chris@16:         : base(object(other))
Chris@16:     {
Chris@16:     }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     str center(T const& width) const
Chris@16:     {
Chris@16:         return base::center(object(width));
Chris@16:     }
Chris@16: 
Chris@16:     template<class T>
Chris@16:     long count(T const& sub) const
Chris@16:     {
Chris@16:         return base::count(object(sub));
Chris@16:     }
Chris@16: 
Chris@16:     template<class T1, class T2>
Chris@16:     long count(T1 const& sub,T2 const& start) const
Chris@16:     {
Chris@16:         return base::count(object(sub), object(start));
Chris@16:     }
Chris@16: 
Chris@16:     template<class T1, class T2, class T3>
Chris@16:     long count(T1 const& sub,T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::count(object(sub), object(start));
Chris@16:     }
Chris@16: 
Chris@16: #if PY_VERSION_HEX < 0x03000000
Chris@16:     object decode() const { return base::decode(); }
Chris@16:     
Chris@16:     template<class T>
Chris@16:     object decode(T const& encoding) const
Chris@16:     {
Chris@16:         return base::decode(object(encoding));
Chris@16:     }
Chris@16: 
Chris@16:     template<class T1, class T2>
Chris@16:     object decode(T1 const& encoding, T2 const& errors) const
Chris@16:     {
Chris@16:         return base::decode(object(encoding),object(errors));
Chris@16:     }
Chris@16: #endif
Chris@16: 
Chris@16:     object encode() const { return base::encode(); }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     object encode(T const& encoding) const
Chris@16:     {
Chris@16:         return base::encode(object(encoding));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     object encode(T1 const& encoding, T2 const& errors) const
Chris@16:     {
Chris@16:         return base::encode(object(encoding),object(errors));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     bool endswith(T const& suffix) const
Chris@16:     {
Chris@16:         return base::endswith(object(suffix));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     bool endswith(T1 const& suffix, T2 const& start) const
Chris@16:     {
Chris@16:         return base::endswith(object(suffix), object(start));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     bool endswith(T1 const& suffix, T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::endswith(object(suffix), object(start), object(end));
Chris@16:     }
Chris@16:     
Chris@16:     str expandtabs() const { return base::expandtabs(); }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     str expandtabs(T const& tabsize) const
Chris@16:     {
Chris@16:         return base::expandtabs(object(tabsize));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T>
Chris@16:     long find(T const& sub) const
Chris@16:     {
Chris@16:         return base::find(object(sub));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     long find(T1 const& sub, T2 const& start) const
Chris@16:     {
Chris@16:         return base::find(object(sub), object(start));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     long find(T1 const& sub, T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::find(object(sub), object(start), object(end));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T>
Chris@16:     long index(T const& sub) const
Chris@16:     {
Chris@16:         return base::index(object(sub));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T1, class T2>
Chris@16:     long index(T1 const& sub, T2 const& start) const
Chris@16:     {
Chris@16:         return base::index(object(sub), object(start));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     long index(T1 const& sub, T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::index(object(sub), object(start), object(end));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     str join(T const& sequence) const
Chris@16:     {
Chris@16:         return base::join(object(sequence));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T>
Chris@16:     str ljust(T const& width) const
Chris@16:     {
Chris@16:         return base::ljust(object(width));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     str replace(T1 const& old, T2 const& new_) const 
Chris@16:     {
Chris@16:         return base::replace(object(old),object(new_));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     str replace(T1 const& old, T2 const& new_, T3 const& maxsplit) const 
Chris@16:     {
Chris@16:         return base::replace(object(old),object(new_), object(maxsplit));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T>
Chris@16:     long rfind(T const& sub) const
Chris@16:     {
Chris@16:         return base::rfind(object(sub));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     long rfind(T1 const& sub, T2 const& start) const
Chris@16:     {
Chris@16:         return base::rfind(object(sub), object(start));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     long rfind(T1 const& sub, T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::rfind(object(sub), object(start), object(end));
Chris@16:     }
Chris@16:     
Chris@16:     template <class T>
Chris@16:     long rindex(T const& sub) const
Chris@16:     {
Chris@16:         return base::rindex(object(sub));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     long rindex(T1 const& sub, T2 const& start) const
Chris@16:     {
Chris@16:         return base::rindex(object(sub), object(start));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     long rindex(T1 const& sub, T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::rindex(object(sub), object(start), object(end));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     str rjust(T const& width) const
Chris@16:     {
Chris@16:         return base::rjust(object(width));
Chris@16:     }
Chris@16:     
Chris@16:     list split() const { return base::split(); }
Chris@16:    
Chris@16:     template <class T>
Chris@16:     list split(T const& sep) const
Chris@16:     {
Chris@16:         return base::split(object(sep));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     list split(T1 const& sep, T2 const& maxsplit) const
Chris@16:     {
Chris@16:         return base::split(object(sep), object(maxsplit));
Chris@16:     }
Chris@16: 
Chris@16:     list splitlines() const { return base::splitlines(); }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     list splitlines(T const& keepends) const
Chris@16:     {
Chris@16:         return base::splitlines(object(keepends));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     bool startswith(T const& prefix) const
Chris@16:     {
Chris@16:         return base::startswith(object(prefix));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     bool startswith(T1 const& prefix, T2 const& start) const
Chris@16:     {
Chris@16:         return base::startswith(object(prefix), object(start));
Chris@16:     }
Chris@16:      
Chris@16:     template <class T1, class T2, class T3>
Chris@16:     bool startswith(T1 const& prefix, T2 const& start, T3 const& end) const
Chris@16:     {
Chris@16:         return base::startswith(object(prefix), object(start), object(end));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T>
Chris@16:     str translate(T const& table) const
Chris@16:     {
Chris@16:         return base::translate(object(table));
Chris@16:     }
Chris@16: 
Chris@16:     template <class T1, class T2>
Chris@16:     str translate(T1 const& table, T2 const& deletechars) const
Chris@16:     {
Chris@16:         return base::translate(object(table), object(deletechars));
Chris@16:     }
Chris@16:     
Chris@16:  public: // implementation detail -- for internal use only
Chris@16:     BOOST_PYTHON_FORWARD_OBJECT_CONSTRUCTORS(str, base)
Chris@16: };
Chris@16: 
Chris@16: //
Chris@16: // Converter Specializations
Chris@16: //
Chris@16: namespace converter
Chris@16: {
Chris@16:   template <>
Chris@16:   struct object_manager_traits<str>
Chris@16: #if PY_VERSION_HEX >= 0x03000000
Chris@16:       : pytype_object_manager_traits<&PyUnicode_Type,str>
Chris@16: #else
Chris@16:       : pytype_object_manager_traits<&PyString_Type,str>
Chris@16: #endif
Chris@16:   {
Chris@16:   };
Chris@16: }
Chris@16: 
Chris@16: }}  // namespace boost::python
Chris@16: 
Chris@16: #endif // STR_20020703_HPP