Merge pull request realpython#261 from ozgur/string_concatenation_note

Kenneth Reitz · Kenneth Reitz · commit fee9fcd990ca · 2013-04-13T20:24:54.000-07:00
Note added on string concatenation
diff --git a/docs/writing/structure.rst b/docs/writing/structure.rst
@@ -463,6 +463,23 @@ should be your preferred method.
     foo += 'ooo'  # This is bad, instead you should do:
     foo = ''.join([foo, 'ooo'])
 
+.. note::
+    You can also use the **%** formatting operator to concatenate the
+    pre-determined number of strings besides **join()** and **+**. However,
+    according to `PEP 3101 <http://www.python.org/dev/peps/pep-3101/>`_,
+    **%** operator became deprecated in Python 3.1 and will be replaced by the
+    **format()** method in the later versions.
+
+.. code-block:: python
+
+    foo = 'foo'
+    bar = 'bar'
+
+    foobar = '%s%s' % (foo, bar) # It is OK
+    foobar = '{0}{1}'.format(foo, bar) # It is better
+    foobar = '{foo}{bar}'.format(foo=foo, bar=bar) # It is best
+
+
 Vendorizing Dependencies
 ------------------------
 
