#34 - Implement method CppStringT::ljust()

Completed.

Author: schmouk

cpp-strings/cppstrings.h

@@ -566,7 +566,7 @@ namespace pcs // i.e. "pythonic c++ strings"
             return first + *this + this->join(others...);
         }
 
-        /** \brief A single parameter signature. Returns a copy of this parameter. */
+        /** \brief Single parameter signature. Returns a copy of this parameter. */
         inline const CppStringT join(const CppStringT& s) const noexcept
         {
             return s;
@@ -579,6 +579,21 @@ namespace pcs // i.e. "pythonic c++ strings"
         }
 
 
+        //---   ljust()   -----------------------------------------
+        /** \brief Returns the string left justified in a string of length width.
+        *
+        * Padding is done using the specified fillchar (default is an ASCII space). 
+        * The original string is returned if width is less than or equal to len(s).
+        */
+        inline CppStringT ljust(const size_type width, const value_type fillch = value_type(' ')) const noexcept
+        {
+            if (this->size() >= width)
+                return *this;
+            else
+                return CppStringT(width - this->size(), fillch) + *this;
+        }
+
+
         //---   lower ()  -----------------------------------------
         /** \brief In-place replaces all characters of the string with their lowercase conversion. Returns a reference to string.
         *