3. Pengantar Informal Tentang Python
************************************

Dalam contoh berikut, masukan dan keluaran dibedakan dengan ada atau
tidaknya prompt (*>>>* dan *...*): untuk mengulangi contoh, Anda harus
mengetikkan semuanya setelah prompt, saat prompt muncul; baris yang
tidak dimulai dengan prompt adalah output dari interpreter. Perhatikan
bahwa baris yang hanya berisi prompt sekunder dalam contoh berarti
Anda harus mengetikkan baris kosong; ini digunakan untuk mengakhiri
perintah multi-baris.

Banyak contoh dalam manual ini, bahkan yang dimasukkan pada prompt
interaktif, termasuk komentar. Komentar dalam Python dimulai dengan
karakter hash, "#", dan diperluas hingga akhir garis fisik. Sebuah
komentar dapat muncul di awal baris atau mengikuti spasi atau kode,
tetapi tidak dalam string literal. Karakter hash dalam string literal
hanyalah karakter hash. Karena komentar adalah untuk mengklarifikasi
kode dan tidak ditafsirkan oleh Python, mereka dapat dihilangkan saat
mengetikkan contoh.

Beberapa contoh:

   # this is the first comment
   spam = 1  # and this is the second comment
             # ... and now a third!
   text = "# This is not a comment because it's inside quotes."


3.1. Menggunakan Python sebagai Kalkulator
==========================================

Mari kita coba beberapa perintah Python sederhana. Mulai interpreter
dan tunggu prompt utama, ">>>". (Seharusnya tidak butuh waktu lama.)


3.1.1. Angka
------------

Interpreter bertindak sebagai kalkulator sederhana: Anda dapat
mengetikkan ekspresi padanya dan itu akan menulis nilainya. Sintaksis
ekspresi mudah: operator "+", "-", "*" dan "/" berfungsi seperti di
sebagian besar bahasa lain (misalnya, Pascal atau C); tanda kurung
("()") dapat digunakan untuk pengelompokan. Sebagai contoh:

   >>> 2 + 2
   4
   >>> 50 - 5*6
   20
   >>> (50 - 5.0*6) / 4
   5.0
   >>> 8 / 5.0
   1.6

Bilangan bulat (mis. "2", "4", "20") memiliki tipe "int", yang
memiliki bagian pecahan (mis.``5.0``,``1.6``) memiliki tipe "float".
Kita akan melihat lebih banyak tentang tipe bilangan nanti dalam
tutorial.

The return type of a division ("/") operation depends on its operands.
If both operands are of type "int", *floor division* is performed and
an "int" is returned.  If either operand is a "float", classic
division is performed and a "float" is returned.  The "//" operator is
also provided for doing floor division no matter what the operands
are.  The remainder can be calculated with the "%" operator:

   >>> 17 / 3  # int / int -> int
   5
   >>> 17 / 3.0  # int / float -> float
   5.666666666666667
   >>> 17 // 3.0  # explicit floor division discards the fractional part
   5.0
   >>> 17 % 3  # the % operator returns the remainder of the division
   2
   >>> 5 * 3 + 2  # result * divisor + remainder
   17

Dengan Python, dimungkinkan untuk menggunakan operator "**" untuk
menghitung pemangkatan [1]:

   >>> 5 ** 2  # 5 squared
   25
   >>> 2 ** 7  # 2 to the power of 7
   128

Tanda sama dengan ("=") digunakan untuk memberikan nilai ke variabel.
Setelah itu, tidak ada hasil yang ditampilkan sebelum prompt
interaktif berikutnya:

   >>> width = 20
   >>> height = 5 * 9
   >>> width * height
   900

Jika variabel tidak "didefinisikan" (diberi nilai), mencoba
menggunakannya akan menghasilkan kesalahan:

   >>> n  # try to access an undefined variable
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
   NameError: name 'n' is not defined

Ada dukungan penuh untuk floating point; operator dengan operan tipe
campuran akan mengubah operan integer ke floating point:

   >>> 3 * 3.75 / 1.5
   7.5
   >>> 7.0 / 2
   3.5

Dalam mode interaktif, ekspresi cetak terakhir diberikan ke variabel
"_". Ini berarti bahwa ketika Anda menggunakan Python sebagai
kalkulator meja, agak lebih mudah untuk melanjutkan perhitungan,
misalnya:

   >>> tax = 12.5 / 100
   >>> price = 100.50
   >>> price * tax
   12.5625
   >>> price + _
   113.0625
   >>> round(_, 2)
   113.06

Variabel ini harus diperlakukan sebagai baca-saja oleh pengguna.
Jangan secara eksplisit memberikan nilai padanya --- Anda akan membuat
variabel lokal independen dengan nama yang sama menutupi variabel
bawaan dengan perilaku saktinya.

Selain "int" dan :class:` float`, Python mendukung tipe angka lainnya,
seperti "Decimal" dan "Fraction". Python juga memiliki dukungan bawaan
untuk complex numbers, dan menggunakan akhiran "j" atau "J" untuk
menunjukkan bagian imajiner (mis. "3+5j").


3.1.2. String
-------------

Selain angka, Python juga dapat memanipulasi string atau teks, yang
dapat diekspresikan dalam beberapa cara. Mereka dapat disertakan dalam
tanda kutip tunggal ("'...'") atau tanda kutip ganda (""..."") dengan
hasil yang sama [2]. "\" dapat digunakan untuk keluar dari kutipan:

   >>> 'spam eggs'  # single quotes
   'spam eggs'
   >>> 'doesn\'t'  # use \' to escape the single quote...
   "doesn't"
   >>> "doesn't"  # ...or use double quotes instead
   "doesn't"
   >>> '"Yes," they said.'
   '"Yes," they said.'
   >>> "\"Yes,\" they said."
   '"Yes," they said.'
   >>> '"Isn\'t," they said.'
   '"Isn\'t," they said.'

In the interactive interpreter, the output string is enclosed in
quotes and special characters are escaped with backslashes.  While
this might sometimes look different from the input (the enclosing
quotes could change), the two strings are equivalent.  The string is
enclosed in double quotes if the string contains a single quote and no
double quotes, otherwise it is enclosed in single quotes.  The "print"
statement produces a more readable output, by omitting the enclosing
quotes and by printing escaped and special characters:

   >>> '"Isn\'t," they said.'
   '"Isn\'t," they said.'
   >>> print '"Isn\'t," they said.'
   "Isn't," they said.
   >>> s = 'First line.\nSecond line.'  # \n means newline
   >>> s  # without print, \n is included in the output
   'First line.\nSecond line.'
   >>> print s  # with print, \n produces a new line
   First line.
   Second line.

Jika Anda tidak ingin karakter yang diawali dengan "\" ditafsirkan
sebagai karakter khusus, Anda dapat menggunakan *raw strings* dengan
menambahkan "r" sebelum kutipan pertama:

   >>> print 'C:\some\name'  # here \n means newline!
   C:\some
   ame
   >>> print r'C:\some\name'  # note the r before the quote
   C:\some\name

String literal dapat melebar hingga beberapa baris. Salah satu caranya
adalah dengan menggunakan tanda kutip tiga: """"..."""" atau
"'''...'''". Akhir baris secara otomatis termasuk dalam string, tetapi
dimungkinkan untuk mencegahnya dengan menambahkan "\" di akhir baris.
Contoh berikut:

   print """\
   Usage: thingy [OPTIONS]
        -h                        Display this usage message
        -H hostname               Hostname to connect to
   """

menghasilkan keluaran berikut (perhatikan bahwa awal baris baru tidak
termasuk):

   Usage: thingy [OPTIONS]
        -h                        Display this usage message
        -H hostname               Hostname to connect to

String dapat digabungkan (direkatkan) dengan operator "+", dan
diulangi dengan "*":

   >>> # 3 times 'un', followed by 'ium'
   >>> 3 * 'un' + 'ium'
   'unununium'

Dua atau lebih *string literals* (yaitu yang terlampir di antara tanda
kutip) di sebelah satu sama lain secara otomatis digabungkan.

   >>> 'Py' 'thon'
   'Python'

Fitur ini sangat berguna ketika Anda ingin memecah string panjang:

   >>> text = ('Put several strings within parentheses '
   ...         'to have them joined together.')
   >>> text
   'Put several strings within parentheses to have them joined together.'

Ini hanya bekerja dengan dua literal, tidak dengan variabel atau
ekspresi:

   >>> prefix = 'Py'
   >>> prefix 'thon'  # can't concatenate a variable and a string literal
     ...
   SyntaxError: invalid syntax
   >>> ('un' * 3) 'ium'
     ...
   SyntaxError: invalid syntax

Jika Anda ingin menggabungkan variabel atau variabel dan literal,
gunakan "+":

   >>> prefix + 'thon'
   'Python'

String dapat diindeks atau *indexed* (disandikan), dengan karakter
pertama memiliki indeks 0. Tidak ada tipe karakter yang terpisah;
sebuah karakter hanyalah sebuah string berukuran satu:

   >>> word = 'Python'
   >>> word[0]  # character in position 0
   'P'
   >>> word[5]  # character in position 5
   'n'

Indeks juga bisa berupa angka negatif, untuk mulai menghitung dari
kanan:

   >>> word[-1]  # last character
   'n'
   >>> word[-2]  # second-last character
   'o'
   >>> word[-6]
   'P'

Perhatikan bahwa karena -0 sama dengan 0, indeks negatif mulai dari
-1.

In addition to indexing, *slicing* is also supported.  While indexing
is used to obtain individual characters, *slicing* allows you to
obtain a substring:

   >>> word[0:2]  # characters from position 0 (included) to 2 (excluded)
   'Py'
   >>> word[2:5]  # characters from position 2 (included) to 5 (excluded)
   'tho'

Perhatikan bagaimana awal selalu disertakan, dan akhirnya selalu
dikecualikan. Ini memastikan bahwa "s[:i] + s[i:]" selalu sama dengan
"s":

   >>> word[:2] + word[2:]
   'Python'
   >>> word[:4] + word[4:]
   'Python'

Indeks irisan memiliki nilai bawaan yang berguna; indeks pertama yang
hilang akan digantikan ke nilai nol, indeks kedua yang hilang akan
digantikan ke nilai ukuran atau panjang string yang diiris.

   >>> word[:2]   # character from the beginning to position 2 (excluded)
   'Py'
   >>> word[4:]   # characters from position 4 (included) to the end
   'on'
   >>> word[-2:]  # characters from the second-last (included) to the end
   'on'

Salah satu cara untuk mengingat bagaimana irisan bekerja adalah dengan
menganggap indeks sebagai menunjuk *between* karakter, dengan tepi
kiri karakter pertama bernomor 0. Kemudian tepi kanan karakter
terakhir dari string *n* karakter memiliki indeks *n*, misalnya:

    +---+---+---+---+---+---+
    | P | y | t | h | o | n |
    +---+---+---+---+---+---+
    0   1   2   3   4   5   6
   -6  -5  -4  -3  -2  -1

Baris pertama angka memberikan posisi indeks 0...6 dalam string; baris
kedua memberikan indeks negatif yang sesuai. Irisan dari *i* ke *j*
terdiri dari semua karakter di antara kedua sisi yang berlabel *i* dan
*j*.

Untuk indeks non-negatif, panjang irisan adalah selisih indeks, jika
keduanya berada dalam batas. Misalnya, panjang "word[1:3]" adalah 2.

Mencoba menggunakan indeks yang terlalu besar akan menghasilkan
kesalahan:

   >>> word[42]  # the word only has 6 characters
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
   IndexError: string index out of range

Namun, indeks irisan di luar jangkauan ditangani dengan anggun ketika
digunakan untuk mengiris:

   >>> word[4:42]
   'on'
   >>> word[42:]
   ''

String python tidak dapat diubah --- mereka adalah *immutable*. Oleh
karena itu, menetapkan ke suatu indeks posisi dalam string
menghasilkan kesalahan:

   >>> word[0] = 'J'
     ...
   TypeError: 'str' object does not support item assignment
   >>> word[2:] = 'py'
     ...
   TypeError: 'str' object does not support item assignment

Jika Anda membutuhkan string yang berbeda, Anda harus membuat yang
baru:

   >>> 'J' + word[1:]
   'Jython'
   >>> word[:2] + 'py'
   'Pypy'

Fungsi bawaan "len()" mengembalikan panjang string:

   >>> s = 'supercalifragilisticexpialidocious'
   >>> len(s)
   34

lihat juga:

  Sequence Types --- str, unicode, list, tuple, bytearray, buffer,
  xrange
     Strings, and the Unicode strings described in the next section,
     are examples of *sequence types*, and support the common
     operations supported by such types.

  String Methods
     Both strings and Unicode strings support a large number of
     methods for basic transformations and searching.

  Format String Syntax
     Informasi tentang pemformatan string dengan "str.format()".

  String Formatting Operations
     The old formatting operations invoked when strings and Unicode
     strings are the left operand of the "%" operator are described in
     more detail here.


3.1.3. Unicode Strings
----------------------

Starting with Python 2.0 a new data type for storing text data is
available to the programmer: the Unicode object. It can be used to
store and manipulate Unicode data (see http://www.unicode.org/) and
integrates well with the existing string objects, providing auto-
conversions where necessary.

Unicode has the advantage of providing one ordinal for every character
in every script used in modern and ancient texts. Previously, there
were only 256 possible ordinals for script characters. Texts were
typically bound to a code page which mapped the ordinals to script
characters. This lead to very much confusion especially with respect
to internationalization (usually written as "i18n" --- "'i'" + 18
characters + "'n'") of software.  Unicode solves these problems by
defining one code page for all scripts.

Creating Unicode strings in Python is just as simple as creating
normal strings:

   >>> u'Hello World !'
   u'Hello World !'

The small "'u'" in front of the quote indicates that a Unicode string
is supposed to be created. If you want to include special characters
in the string, you can do so by using the Python *Unicode-Escape*
encoding. The following example shows how:

   >>> u'Hello\u0020World !'
   u'Hello World !'

The escape sequence "\u0020" indicates to insert the Unicode character
with the ordinal value 0x0020 (the space character) at the given
position.

Other characters are interpreted by using their respective ordinal
values directly as Unicode ordinals.  If you have literal strings in
the standard Latin-1 encoding that is used in many Western countries,
you will find it convenient that the lower 256 characters of Unicode
are the same as the 256 characters of Latin-1.

For experts, there is also a raw mode just like the one for normal
strings. You have to prefix the opening quote with 'ur' to have Python
use the *Raw-Unicode-Escape* encoding. It will only apply the above
"\uXXXX" conversion if there is an uneven number of backslashes in
front of the small 'u'.

   >>> ur'Hello\u0020World !'
   u'Hello World !'
   >>> ur'Hello\\u0020World !'
   u'Hello\\\\u0020World !'

The raw mode is most useful when you have to enter lots of
backslashes, as can be necessary in regular expressions.

Apart from these standard encodings, Python provides a whole set of
other ways of creating Unicode strings on the basis of a known
encoding.

The built-in function "unicode()" provides access to all registered
Unicode codecs (COders and DECoders). Some of the more well known
encodings which these codecs can convert are *Latin-1*, *ASCII*,
*UTF-8*, and *UTF-16*. The latter two are variable-length encodings
that store each Unicode character in one or more bytes. The default
encoding is normally set to ASCII, which passes through characters in
the range 0 to 127 and rejects any other characters with an error.
When a Unicode string is printed, written to a file, or converted with
"str()", conversion takes place using this default encoding.

   >>> u"abc"
   u'abc'
   >>> str(u"abc")
   'abc'
   >>> u"äöü"
   u'\xe4\xf6\xfc'
   >>> str(u"äöü")
   Traceback (most recent call last):
     File "<stdin>", line 1, in ?
   UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-2: ordinal not in range(128)

To convert a Unicode string into an 8-bit string using a specific
encoding, Unicode objects provide an "encode()" method that takes one
argument, the name of the encoding.  Lowercase names for encodings are
preferred.

   >>> u"äöü".encode('utf-8')
   '\xc3\xa4\xc3\xb6\xc3\xbc'

If you have data in a specific encoding and want to produce a
corresponding Unicode string from it, you can use the "unicode()"
function with the encoding name as the second argument.

   >>> unicode('\xc3\xa4\xc3\xb6\xc3\xbc', 'utf-8')
   u'\xe4\xf6\xfc'


3.1.4. List
-----------

Python mengetahui sejumlah tipe data *compound* atau gabungan, yang
digunakan untuk mengelompokkan nilai-nilai lainnya. Yang paling
serbaguna adalah *list*, yang dapat ditulis sebagai daftar nilai yang
dipisahkan koma (item) antara tanda kurung siku. List atau daftar
mungkin berisi item dari tipe yang berbeda, tetapi biasanya semua item
memiliki tipe yang sama.

   >>> squares = [1, 4, 9, 16, 25]
   >>> squares
   [1, 4, 9, 16, 25]

Like strings (and all other built-in *sequence* type), lists can be
indexed and sliced:

   >>> squares[0]  # indexing returns the item
   1
   >>> squares[-1]
   25
   >>> squares[-3:]  # slicing returns a new list
   [9, 16, 25]

All slice operations return a new list containing the requested
elements.  This means that the following slice returns a new (shallow)
copy of the list:

   >>> squares[:]
   [1, 4, 9, 16, 25]

Lists also supports operations like concatenation:

   >>> squares + [36, 49, 64, 81, 100]
   [1, 4, 9, 16, 25, 36, 49, 64, 81, 100]

Tidak seperti string, yang *immutable*, list adalah *mutable*, mis.
dimungkinkan untuk mengubah kontennya:

   >>> cubes = [1, 8, 27, 65, 125]  # something's wrong here
   >>> 4 ** 3  # the cube of 4 is 64, not 65!
   64
   >>> cubes[3] = 64  # replace the wrong value
   >>> cubes
   [1, 8, 27, 64, 125]

Anda juga dapat menambahkan item baru di akhir list, dengan
menggunakan *method* "append()" (kita akan melihat lebih banyak
tentang metode nanti):

   >>> cubes.append(216)  # add the cube of 6
   >>> cubes.append(7 ** 3)  # and the cube of 7
   >>> cubes
   [1, 8, 27, 64, 125, 216, 343]

Pemberian nilai untuk irisan juga dimungkinkan, dan ini bahkan dapat
mengubah ukuran list atau menghapus seluruhnya:

   >>> letters = ['a', 'b', 'c', 'd', 'e', 'f', 'g']
   >>> letters
   ['a', 'b', 'c', 'd', 'e', 'f', 'g']
   >>> # replace some values
   >>> letters[2:5] = ['C', 'D', 'E']
   >>> letters
   ['a', 'b', 'C', 'D', 'E', 'f', 'g']
   >>> # now remove them
   >>> letters[2:5] = []
   >>> letters
   ['a', 'b', 'f', 'g']
   >>> # clear the list by replacing all the elements with an empty list
   >>> letters[:] = []
   >>> letters
   []

Fungsi bawaan "len()" juga berlaku untuk list:

   >>> letters = ['a', 'b', 'c', 'd']
   >>> len(letters)
   4

Dimungkinkan untuk membuat list atau daftar bersarang (membuat daftar
yang berisi daftar lain), misalnya:

   >>> a = ['a', 'b', 'c']
   >>> n = [1, 2, 3]
   >>> x = [a, n]
   >>> x
   [['a', 'b', 'c'], [1, 2, 3]]
   >>> x[0]
   ['a', 'b', 'c']
   >>> x[0][1]
   'b'


3.2. Langkah Awal Menuju Pemrograman
====================================

Of course, we can use Python for more complicated tasks than adding
two and two together.  For instance, we can write an initial sub-
sequence of the *Fibonacci* series as follows:

   >>> # Fibonacci series:
   ... # the sum of two elements defines the next
   ... a, b = 0, 1
   >>> while b < 10:
   ...     print b
   ...     a, b = b, a+b
   ...
   1
   1
   2
   3
   5
   8

Contoh ini memperkenalkan beberapa fitur baru.

* Baris pertama berisi *multiple assignment*: variabel "a" dan "b"
  secara bersamaan mendapatkan nilai-nilai baru 0 dan 1. Pada baris
  terakhir ini digunakan lagi, menunjukkan bahwa ekspresi di sisi
  sebelah kanan, semua dievaluasi terlebih dahulu sebelum salah satu
  pemberian nilai berlangsung. Ekspresi sisi kanan dievaluasi dari
  kiri ke kanan.

* The "while" loop executes as long as the condition (here: "b <
  10") remains true.  In Python, like in C, any non-zero integer value
  is true; zero is false.  The condition may also be a string or list
  value, in fact any sequence; anything with a non-zero length is
  true, empty sequences are false.  The test used in the example is a
  simple comparison.  The standard comparison operators are written
  the same as in C: "<" (less than), ">" (greater than), "==" (equal
  to), "<=" (less than or equal to), ">=" (greater than or equal to)
  and "!=" (not equal to).

* *body* dari pengulangan adalah *indentasi*: indentasi adalah cara
  Python untuk pengelompokan pernyataan. Pada prompt interaktif, Anda
  harus mengetikkan tab atau spasi(-spasi) untuk setiap baris yang
  diberikan indentasi. Dalam praktiknya Anda akan menyiapkan masukan
  yang lebih rumit untuk Python dengan editor teks; semua editor teks
  yang baik memiliki fasilitas indentasi otomatis. Ketika pernyataan
  majemuk dimasukkan secara interaktif, harus diikuti oleh baris
  kosong untuk menunjukkan penyelesaian (karena pengurai tidak dapat
  menebak kapan Anda mengetik baris terakhir). Perhatikan bahwa setiap
  baris dalam blok dasar harus diindentasi dengan jumlah yang sama.

* The "print" statement writes the value of the expression(s) it is
  given.  It differs from just writing the expression you want to
  write (as we did earlier in the calculator examples) in the way it
  handles multiple expressions and strings.  Strings are printed
  without quotes, and a space is inserted between items, so you can
  format things nicely, like this:

     >>> i = 256*256
     >>> print 'The value of i is', i
     The value of i is 65536

  A trailing comma avoids the newline after the output:

     >>> a, b = 0, 1
     >>> while b < 1000:
     ...     print b,
     ...     a, b = b, a+b
     ...
     1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987

  Note that the interpreter inserts a newline before it prints the
  next prompt if the last line was not completed.

-[ Catatan kaki ]-

[1] Karena "**" memiliki prioritas lebih tinggi dari "-", "-3**2"
    akan ditafsirkan sebagai "-(3**2)" dan karenanya menghasilkan
    "-9". Untuk menghindari ini dan mendapatkan "9", Anda dapat
    menggunakan "(-3)**2".

[2] Tidak seperti bahasa lain, karakter khusus seperti "\n"
    memiliki arti yang sama dengan kedua tanda kutip tunggal ("'...'")
    dan ganda (""...""). Satu-satunya perbedaan antara keduanya adalah
    bahwa dalam tanda kutip tunggal Anda tidak perlu memisahkan """
    (tetapi Anda harus memisahkan "\'") dan sebaliknya.
