Bantuan:Ungkapan bersyarat

Lihat versi terbaru di (Inggris)m:Help:ParserFunctions

ParserFunctions (fungsi-fungsi parser) adalah sekumpulan fungsi-fungsi logika dan kalkulasi dalam MediaWiki: mw:Extension:ParserFunctions. Sejak pertengahan April 2006 piranti lunak MediaWiki dengan menggunakan Sintaks-Wiki memperbolehkan digunakannya beberapa konstruksi suatu bahasa pemrograman untuk diterapkan dalam templat.

Konstruksi-konstruksi bahasa program ini seharusnya hanya digunakan secara eksklusif dalam ruang nama templat dan dipertimbangkan saat digunakan. Tidak setiap kemungkinan pemanfaatannya benar-benar berarti atau bermanfaat. Sintaks-sintaks bahasa pemrograman ini masih dapat berubah. Konstruksi pemrograman yang tidak cukup terdokumentasi, akan kembali dihapuskan.

Berbeda dengan fungsi parser biasa yang bisa tidak menggunakan tanda pagar "#", penggunaan ParserFunctions harus memakai tanda pagar di awal fungsi. ParserFunctions memiliki sintaks seperti berikut:

• {{#namafungsi: argumen1 | argumen2 | argumen3..}}

Mohon perhatikan bahwa ekstensi ini harus dipasang secara manual, dan tidak langsung terpasang ketika sebuah MediaWiki baru dipasang. Lihat Istimewa:Versi untuk mengetahui apakan ekstensi ini sudah dipasang atau belum.

Fungsi-fungsi

Sekarang ini, modul ini memiliki sepuluh fungsi yaitu: expr, if, ifeq, ifexist, ifexpr, iferror, switch, time, rel2abs, dan titleparts.

#expr:

sintaks:

• {{ #expr: ekspresi }}

Fungsi expr digunakan untuk menghitung perhitungan (ekspresi) matematika didasarkan atas permutasi dari angka-angka (atau variabel/parameter yang diterjemahkan dalam angka-angka) dan operator. Fungsi ini tidak berlaku untuk string. (gunakan ifeq untuk string). Keakuratan dan format angka berbeda-beda tergantung dari sistem operasi peladen.

Dalam perhitungan kompleks, operator dihitung dari kiri ke kanan dengan preseden tertentu:

1. pengelompokan (tanda kurung);
2. unary (tanda +/- dan NOT);
3. perkalian(*, /, div, mod);
4. penjumlahan (+, -);
5. pembulatan;
6. perbandingan (=, !=, <, >, dll.);
7. logical AND;
8. logical OR.

Jika menghitung sebagai boolean, "0" dianggap FALSE (salah) dan karakter lain selain spasi "TRUE" (benar) (TRUE di boolean dilambangkan sebagai "1").

Macam operator:

Operator	Operasi	Contoh	Hasil
tidak ada		{{ #expr: 123456789012345 }}	1.2345678901234E+14
		{{ #expr: 0.000001 }}	1.0E-6
Aritmatika
+	Unary tanda positif	{{ #expr: +30 * +7 }}	210
-	Unary tanda negatif	{{ #expr: -30 * -7 }}	210
*	Perkalian	{{ #expr: 30 * 7 }}	210
/ div	Pembagian	{{ #expr: 30 / 7 }} {{ #expr: 30 div 7 }}	4.2857142857143 4.2857142857143
+	Penjumlahan	{{ #expr: 30 + 7 }}	37
-	Pengurangan	{{ #expr: 30 - 7 }}	23
Logika
not	Unary NOT logical NOT	{{ #expr: not 0 * 7 }} {{ #expr: not 30 + 7 }}	7 7
and	Logical AND	{{ #expr: 4 < 5 and 4 mod 2 }}	0
or	Logical OR	{{ #expr: 4 < 5 or 4 mod 2 }}	1
Perbandingan
=	Persamaan (numerical & logical)	{{ #expr: 30 = 7 }}	0
<> !=	Pertidaksamaan, logical exclusive or	{{ #expr: 30 <> 7 }} {{ #expr: 1 != 0 }}	1 1
<	Kurang dari	{{ #expr: 30 < 7 }}	0
>	Lebih dari	{{ #expr: 30 > 7 }}	1
<=	Kurang dari sama dengan	{{ #expr: 30 <= 7 }}	0
>=	Lebih dari sama dengan	{{ #expr: 30 >= 7 }}	1
Lain-lain
( )	Operator pengelompokan	{{ #expr: (30 + 7) * 7 }}	259
mod	"Modulo" sisa pembagian. Catatan: div dan mod berbeda dari semua bahasa pemrograman.	{{ #expr: 30 mod 7 }} {{ #expr: -8 mod -3 }} {{ #expr: 8 mod 2.7 }}	2 -2 0
round	Membulatkan.	{{ #expr: 30 / 7 round 4 }} {{ #expr: 30 / 7 round 1 }} {{ #expr: 1911 round -2 }} {{ #expr: -2.5 round 0 }}	4.2857 4.3 1900 -3
trunc	Menghilangkan desimal.	{{ #expr: trunc1.2 }} {{ #expr: trunc-1.2 }}	1 -1
floor	Membulatkan ke intejer terdekat yang sama dengan atau lebih kecil dari angka tersebut.	{{ #expr: floor1.2 }} {{ #expr: floor-1.2 }}	1 -2
ceil	Membulatkan ke intejer terdekat yang sama dengan atau lebih besar dari angka tersebut.	{{ #expr: ceil1.2 }} {{ #expr: ceil-1.2 }}	2 -1

#if:

sintaks:

• {{ #if: <string kondisi> | <kode jika benar> }}

atau bisa juga dilihat dalam pola if-then-else sebagai berikut:

• {{ #if: <string kondisi> | <kode jika benar> | <kode jika salah> }}

Fungsi if bekerja seperti if-then-else (jika-maka-jika_tidak). Kondisi yang diberikan akan selalu benar kecuali dikosongkan atau hanya berisi spasi. Kode di argumen kedua akan dijalankan jika nilai fungsinya benar, dan argumen ketiga akan dijalankan jika nilai fungsinya salah (salah satu atau keduanya dapat kosong, dan kode-jika-salah dapat tidak ditulis sama sekali).

Perbandingan yang dilakukan adalah untuk teks, bukan ekspresi matematika, jadi perbandingan matematika akan selalu dianggap benar; Contoh: {{#if: 1 = 2|benar|salah}} akan menghasilkan "benar", karena string "1 = 2" tidak merupakan string kosong. Untuk membandingkan string gunakan ifeq. Sedangkan untuk membandingkan angka, gunakan ifexpr. <--- It is not possible to distinguish between an undefined parameter in a template and a blank one (it is possible with #ifexpr). -->

Fungsi if digunakan untuk menggantikan pemakaian "hiddenstructure" dan templat {{qif}}. Templat {{qif}} memiliki tingkat kompleksitas tinggi yang menyebabkan waktu yang lama untuk menghasilkan halaman wiki yang memakai templat tersebut.

Contoh:

• {{ #if: foo | lakukan jika benar | lakukan jika salah }}

= lakukan jika benar

• {{ #if: 0 | lakukan jika benar | lakukan jika salah }}

= lakukan jika benar

• {{ #if: | lakukan jika benar | lakukan jika salah }}

= lakukan jika salah

Dalam templat, function if dapat digunakan dalam sintaks berikut:

                         {{Templat|parameter=sesuatu}}  {{Templat}}          {{Templat|parameter=}}
                                      |                       |                         |
                                      |                       |                         |
                                      |                       |                         |
{{#if: {{{parameter|}}} | parameter didefinisikan | parameter tidak didefinisikan atau kosong }}

#ifeq:

sintaks:

• {{ #ifeq: <teks 1> | <teks 2> | <kode jika setara> }}

• {{ #ifeq: <teks 1> | <teks 2> | <kode jika setara> | <kode jika tak setara> }}

Fungsi ifeq membandingkan dua string atau angka, dan akan menghasilkan argumen ketiga jika nilai fungsinya benar, atau akan menghasilkan argumen keempat jika nilai fungsinya salah (salah satu atau keduanya dapat kosong, dan kode-jika-tak-setara dapat tidak ditulis sama sekali).

Perbandingan string ini sensitif terhadap huruf besar/huruf kecil (contoh, A != a). Jika kedua string dapat dijadikan angka, mereka akan dibandingkan secara numerikal (contoh, 01 = 1); Untuk memaksa perbadingan string, tambahkan karakter non-angka (seperti tanda kutip ") pada kedua argumen.

Isu: (belum diterjemahkan)

Contoh:

• {{ #ifeq: teks 1 | teks 2 | kode setara | kode tak setara }}

= kode tak setara

• {{ #ifeq: teks 1 | teks 1 | kode setara | kode tak setara }}

= kode setara

#ifexist:

sintaks:

• {{ #ifexist: <nama halaman> | <kode jika ada> | <kode jika tidak ada> }}

Fungsi ifexist menghasilkan salah satu dari dua kemungkinan, tergantung dari apakah nama halaman yang dimasukkan ada atau tidak.

Contoh:

#ifexpr:

sintaks:

• {{ #ifexpr: <ekspresi> | <maka> | <jika tidak> }}

Fungsi ifexpr menghitung suatu operasi (ekspresi) matematika (lihat expr) dan menghasilkan salah satu dari dua kemungkinan, tergantung dari perhitungan tersebut benar atau salah.

Contoh:

{{ #ifexpr: 10 > 9 | ya | tidak }}

ya -- Karena 10 lebih besar dari 9

switch

Function ini digunakan untuk membandingkan beberapa kondisi seperti dalam penggunaan nested if. Function ini memiliki sintaks:

{{ #switch: <nilai yang dibandingkan>
|<nilai_1> = <hasil_1>
|<nilai_2> = <hasil_2>
|...
|<nilai_n> = <hasil_n>
|<hasil_default>
}}

switch akan mencari setiap nilai sampai sebuah nilai ditemukan cocok dengan nilai yang dibandingkan dan hasil dari nilai yang cocok itu dikembalikan. Jika tidak ada nilai yang cocok dan nilai terakhir tidak memiliki tanda "sama dengan", maka nilai tersebut yang akan dikembalikan. Nilai default dapat juga didefinisikan memakai tanda "sama dengan" menggunakan #default seperti sintaks berikut:

{{ #switch: <nilai yang dibandingkan>
|<nilai_1> = <hasil_1>
|<nilai_2> = <hasil_2>
|...
|<nilai_n> = <hasil_n>
|#default = <hasil default>
}}

Untuk menghindari mengetik hasil yang sama untuk nilai yang berbeda, dapat menggunakan sintaks berikut:

{{ #switch: <nilai yang dibandingkan>
|<nilai_1> =
|<nilai_2> =
|<nilai_3> = <hasil_3>
|...
|<nilai_n> = <hasil_n>
|<hasil default>
}}

Perhatikan bahwa <nilai_1> dan <nilai_2> tidak memiliki tanda "sama dengan". Jika nilai ini yang cocok, hasil yang dikembalikan adalah <hasil_3>.

#time

Function ini memiliki sintaks:

{{ #time: format }}

atau

{{ #time: format | waktu }}

Fungsi "time" digunakan untuk menampilkan waktu (jam/tanggal) dalam berbagai format. Jika waktu tidak diberikan, fungsi "time" akan memakai waktu saat artikel yang bersangkutan dikonversi ke HTML. Dikarenakan adanya cache, halaman yang memakai fungsi ini perlu untuk diperbaharui dengan purge atau null edit.

Kode	Deskripsi	Contoh
d	Hari, dengan awalan nol jika diperlukan.	21
D	Tiga huruf sebagai singkatan nama hari.	Rab
j	Hari, tanpa awalan nol.	21
l	Nama hari.	Rabu
F	Nama bulan.	Agustus
m	Bulan, dengan awalan nol jika diperlukan.	08
M	Tiga huruf singkatan nama bulan.	Ags
n	Bulan, tanpa awalan nol.	8
Y	Empat digit tahun.	2024
y	Dua digit tahun.	24
H	Jam, dengan awalan nol jika diperlukan.	18
i	Menit, dengan awalan nol jika diperlukan.	25
s	Detik, dengan awalan nol jika diperlukan.	28

Ketentuan-ketentuan yang berlaku:

• Karakter format yang tidak dikenal akan ditampilkan apa adanya.
• Karakter-karakter dalam tanda kutip akan ditampilkan apa adanya tanpa diformat, contoh:
  • {{ #time: "Sekarang bulan " F}} → Sekarang bulan Januari
  • {{ #time:i's"}} → 20'11"
• Karakter escape backslash seperti dalam fungsi date() di PHP's juga dikenal. \H menghasilkan huruf H, \" menghasilkan ".

Kode-kode format tambahan mungkin akan ditambahkan di masa mendatang. Fungsi "time" juga mengenal format waktu relatif dan absolut seperti "11 Desember" dan atau "+10 hours" yang bisa digunakan dalam konversi zona waktu.

Jika nilai dari eskpresi menghasilkan nol, maka <else> akan dikembalikan, selain itu <then> akan dikembalikan. <ekspresi> sama dengan pemakaian pada function expr. Function ini merupakan bentuk pendek dari ..

Contoh

• {{#time:j F Y|-14 days}} menghasilkan 7 Agustus 2024 (14 hari yang lalu)
• {{#time:H:i|+7 hours}} menghasilkan 01:25 (7 jam selisih dari UTC, =WIB)
• {{#time:H:i|8:15 +6 hours}} menghasilkan 14:15

rel2abs

Function ini memiliki sintaks:

{{ #rel2abs: <path> }}

{{ #rel2abs: <path> | <base path> }}

{{#rel2abs}} melakukan konversi sebuah relative path ke absolute path.

Contoh:

• Di dalam Bantuan:Foo/bar, {{#rel2abs|../baz}} menghasilkan Bantuan:Foo/baz
• Di dalam Bantuan:Foo, {{#rel2abs|../baz}} menghasilkan baz
• Di dalam Bantuan:Foo, {{#rel2abs|../../baz}} menghasilkan Error: Invalid depth in path: "Help:Foo/../../baz" (tried to access a node above the root node)"
• {{#rel2abs|../baz | Bantuan:Bar/foo}} menghasilkan Bantuan:Bar/baz
• {{#rel2abs|Bantuan:Foo/bar/../baz}} menghasilkan Bantuan:Foo/baz

titleparts

Function ini memiliki sintaks:

{{ #titleparts: judul halaman | tingkat }}

Fungsi ini akan mengambalikan bagian dari suatu judul halaman sesuai tingkat yang diisi pada parameter. Contoh:

{{#titleparts:ABC/DEF/GHI|1}} menghasilkan ABC

{{#titleparts:ABC/DEF/GHI|2}} menghasilkan ABC/DEF

{{#titleparts:ABC/DEF/GHI|3}} menghasilkan ABC/DEF/GHI

Lihat pula

• (Inggris) ParserFunction on meta
• Bantuan:Variabel
• Templat di Wikipedia bahasa Indonesia yang menggunakan ParserFunction