Added first examples into String.

String convertToString( const T& value );

/////

// \brief Class for managing strings.

/// \brief Class for managing strings.

///

/// \par Example

/// \include StringExample.cpp

/// \par Output

/// \include StringOutput.cpp

class String

{

   public:

      /////

      /// \brief Basic constructor. Constructs an empty string object, with the length of zero characters.

      /// \brief Basic constructor.

      ///

      /// Constructs an empty string object with the length of zero characters.

      String();

      /////

      /// to be omitted from the string \e c.

      /// @param sufix_cut_off Determines the length of the sufix that is going

      /// to be omitted from the string \e c.

      ///

      /// \par Example

      /// \code String str( "xxstringxxx", 2, 3 ); \endcode

      ///

      /// \par Output

      /// str = string

      String( const char* c,

              int prefix_cut_off = 0,

              int sufix_cut_off = 0 );

      /// \brief Copy constructor.

      ///

      /// Constructs a copy of the string \e str.

      ///

      /// \par Example

      /// \code

            String str1( "Something" );

            String str2( str1 );

      /// \endcode

      /// \par Output

      /// str1 = Something \n str2 = Something

      String( const String& str );

      /// \brief Converts anything to a string.

      ///

      /// This function converts any type of value into type string.

      /// @param value Word of any type (e.g. int, bool, double,...).

      template< typename T >

      explicit

      String( T value )

      /////

      /// Reserves space for given \e size.

      /// Requests to allocate storage for given \e size.

      /// It allocates one more byte for the terminating 0.

      /// @param size Number of characters.

      void setSize( int size );

      /// success in reading the file.

      bool load( File& file );

      // !!! Mozem dat prec??? 

      // Broadcast to other nodes in MPI cluster

      //   void MPIBcast( int root, MPI_Comm mpi_comm = MPI_COMM_WORLD );

      /// Length of allocated piece of memory.

      int length;

};

}; // class String

/// Returns concatenation of \e string1 and \e string2.

String operator+( char string1, const String& string2 );