Update 'ref/models/instances.txt' (#224)

sgryjp · sgryjp · commit 19ea9c1fa677 · 2015-01-01T22:16:26.000+09:00
1.0〜1.4間の変更差分を適用する前に、__str__ の章と __unicode__ の章の順序変
更を先に反映（以後のdiffを確認しやすくするため）。
diff --git a/ref/models/instances.txt b/ref/models/instances.txt
@@ -4,7 +4,7 @@
 モデルインスタンスリファレンス
 ===============================
 
-:revision-up-to: 13211 (1.1) unfinished
+:revision-up-to: 17812 (1.4) unfinished
 
 .. currentmodule:: django.db.models
 
@@ -248,6 +248,31 @@ Deleting objects
 
 モデルには、特殊な使われ方をするメソッドがあります:
 
+``__unicode__``
+---------------
+
+.. method:: Model.__unicode__()
+
+``__unicode__()`` メソッドは、オブジェクトに対して ``unicode()`` を呼び出し
+た際に呼び出されます。Django のデータベースバックエンドはモデルの属性値とし
+て Unicode 文字列を返すので、通常はモデルの ``__unicode__()`` メソッドを定
+義するとよいでしょう。前節の例を ``__unicode__()`` を使って書き直すと、以下
+のように簡単になります::
+
+    class Person(models.Model):
+        first_name = models.CharField(max_length=50)
+        last_name = models.CharField(max_length=50)
+
+        def __unicode__(self):
+            return u'%s %s' % (self.first_name, self.last_name)
+
+モデルに ``__unicode__()`` メソッドだけを定義して、 ``__str__()`` は定義し
+ないでおくと、 Django が自動的に ``__str__()`` メソッドをモデルに追加します。
+この ``__str__()`` メソッドは、 ``__unicode__()`` を呼び出して、その戻り値
+を UTF-8 でエンコードした文字列を返します。開発上はこの仕様に従い、
+``__unicode__()`` だけを定義して、文字列オブジェクトへの変換は Django 任せ
+にするよう勧めます。
+
 ``__str__``
 -----------
 
@@ -274,31 +299,6 @@ Deleting objects
             # django.utils.encoding.smart_str() を使う
             return smart_str('%s %s' % (self.first_name, self.last_name))
 
-``__unicode__``
----------------
-
-.. method:: Model.__unicode__()
-
-``__unicode__()`` メソッドは、オブジェクトに対して ``unicode()`` を呼び出し
-た際に呼び出されます。Django のデータベースバックエンドはモデルの属性値とし
-て Unicode 文字列を返すので、通常はモデルの ``__unicode__()`` メソッドを定
-義するとよいでしょう。前節の例を ``__unicode__()`` を使って書き直すと、以下
-のように簡単になります::
-
-    class Person(models.Model):
-        first_name = models.CharField(max_length=50)
-        last_name = models.CharField(max_length=50)
-
-        def __unicode__(self):
-            return u'%s %s' % (self.first_name, self.last_name)
-
-モデルに ``__unicode__()`` メソッドだけを定義して、 ``__str__()`` は定義し
-ないでおくと、 Django が自動的に ``__str__()`` メソッドをモデルに追加します。
-この ``__str__()`` メソッドは、 ``__unicode__()`` を呼び出して、その戻り値
-を UTF-8 でエンコードした文字列を返します。開発上はこの仕様に従い、
-``__unicode__()`` だけを定義して、文字列オブジェクトへの変換は Django 任せ
-にするよう勧めます。
-
 ``get_absolute_url``
 --------------------
 
