Xem mã nguồn của Trợ giúp:Tính toán

{{Wikipedia how to}}{{lỗi thời}}
Trong [[Wikipedia]] và các dự án của [[Wikimedia]], có thể thực hiện một số phép tính đơn giản sử dụng mã  
:<kbd><nowiki>{{</nowiki>'''#tênhàm''': ''tham số 1'' | ''tham số 2'' | ''tham số 3'' ... <nowiki>}}</nowiki></kbd>

Hiện tại các hàm sau đang hoạt động: <code>#expr</code>, <code>#if</code>, <code>#ifeq</code>, <code>#iferror</code>, <code>#ifexist</code>, <code>#ifexpr</code>, <del><code>#rand</code></del>, <code>#rel2abs</code>, <code>#switch</code>, <code>#titleparts</code>. Các phép tính được thực hiện bởi máy chủ (server) chạy [[Wikimedia]].

'''Cảnh báo:''' Phần mở rộng này chỉ đang được thử nghiệm<ref>{{Chú thích web|url=http://mail.wikipedia.org/pipermail/wikitech-l/2006-April/034892.html|title=Phần mở rộng này chỉ đang được thử nghiệm.}}</ref>. Người phát triển phần mềm đã bật tính năng này lên có thể tắt nó bất cứ lúc nào, cho nên bạn cần phải theo dõi các trang và tiêu bản có sử dụng cú pháp này phòng trường hợp nó bị tắt, để các trang không bị đổ vỡ. Xin hãy xếp các tiêu bản dùng những hàm này vào [[:Thể loại:Bản mẫu dùng ParserFunctions]].

== #expr ==
{| class="prettytable" style=float:right width=30%  margin-left=1em align=right
|-
!{{hl1}} | Loại
!{{hl1}} | Toán tử
|-
|{{hl2}} | Nhóm (các dấu ngoặc)
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | ( )
|-
|{{hl2}} | Số
| style="word-spacing:0.5em;" | <kbd>'''1234.5'''</kbd> <kbd>'''2.4E5'''</kbd> <kbd>'''e'''</kbd>&nbsp;(2.718) <kbd>'''pi'''</kbd>&nbsp;(3.142)
|-
|{{hl2}} rowspan="3" | Logic
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | or
|-
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | and
|-
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | = != <> > < <= >=
|-
|{{hl2}} | Làm tròn
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | round
|-
|{{hl2}} rowspan="3" | Toán tử hai ngôi
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | + - mod
|-
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | * / div
|-
| <kbd>'''^'''</kbd>
|-
|{{hl2}} rowspan="2" | Toán tử một ngôi
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | not ceil trunc floor abs ln sin cos tan acos asin atan
|-
| style="word-spacing:0.5em; font-family:monospace; font-weight:bold;" | e + -
|}
Hàm này định giá trị của một biểu thức toán học và trả về giá trị đã tính được.

:<kbd><nowiki>{{#expr:</nowiki> ''biểu thức'' <nowiki>}}</nowiki></kbd>

Các toán tử hợp lệ được liệt kê ở bên phải theo trật tự quyền ưu tiên. Xem thông tin chi tiết về hàm số của mỗi toán tử tại<ref>{{Chú thích web|http://meta.wikimedia.org/wiki/Help:Calculation|title=Thông tin toán tử.}}</ref>. Độ chính xác và định dạng của kết quả trả về sẽ thay đổi tùy thuộc vào hệ điều hành của máy chủ (server) chạy wiki, và tùy thuộc vào định dạng số trên ngôn ngữ trang.

Khi định giá sử dụng [[đại số boolean]], 0 tương ứng với <kbd>false</kbd> còn bất kì giá trị khác 0 nào khác, cả âm và dương đều tương ứng với <kbd>true</kbd>:

:<kbd><nowiki>{{#expr: 1 and -1 }}</nowiki></kbd> &rarr; '''{{#expr: 1 and -1 }}'''
:<kbd><nowiki>{{#expr: 1 and 0 }}</nowiki></kbd> &rarr; '''{{#expr: 1 and 0 }}'''

Một biểu thức nhập rỗng sẽ trả về một chuỗi rỗng. Biểu thức không hợp lệ sẽ trả về một trong những thông báo lỗi, có thể bắt các lỗi này bằng cách dùng hàm <kbd>[[##iferror|#iferror]]</kbd>:

:<kbd><nowiki>{{#expr: }}</nowiki></kbd> &rarr; ''' {{#expr: }}'''
:<kbd><nowiki>{{#expr: 1+ }}</nowiki></kbd> &rarr; '''{{#expr: 1+ }}'''
:<kbd><nowiki>{{#expr: 1 foo 2 }}</nowiki></kbd> &rarr; '''{{#expr: 1 foo 2 }}'''

{{warning|Một số biểu thức có thể gây ra lỗi tràn [[số thực]] khi tính các số cực lớn hay cực bé:<br />
<kbd><nowiki>{{#expr: 20060618093259 mod 10000}}</nowiki></kbd> &rarr; '''{{#expr: 20060618093259 mod 10000}}''' trong đa số các trường hợp, nhưng cũng có thể cho kết quả là '''-6357'''.  Điều này thay đổi tùy thuộc vào đặc điểm và cấu hình của máy chủ (server) chạy wiki..
}} Xem [https://bugzilla.wikimedia.org/show_bug.cgi?id=6356 bugzilla 6356].


Ví dụ:

:<code><nowiki>{{#expr: (100 - 32) / 9 * 5 round 0}}</nowiki></code>

cho:

:{{#expr: (100 - 32) / 9 * 5 round 0}}

phép tính này cho biết 100[[độ F|&deg;F]] tương đương với bao nhiêu [[độ C|&deg;C]], làm tròn đến [[số nguyên]].


=== Các toán tử ===

{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
! ''Toán tử''
! ''Phép tính''
! ''Ví dụ''
|-
| không|| không
|
{| class="wikitable"
|{{xpd0|#expr:123456789012345|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:1.23456789012345|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:.000001|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:.00000123456789012345|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:.123e4|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:123E-2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:e|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:pi|gives={{!}}{{!}}}}
|}

Sai:
{| class="wikitable"
|{{xpd0|#expr:e4|gives={{!}}{{!}}}}
|}
|-
! exp
| 
|
{| class="wikitable"
|{{xpd0|#expr:exp1.2|gives={{!}}{{!}}}}
|}

So sánh:
{| class="wikitable"
|{{xpd0|#expr:e^1.2|gives={{!}}{{!}}}}
|}
|-
! ln
| Logarit tự nhiên
|
{| class="wikitable"
|{{xpd0|#expr:ln2|gives={{!}}{{!}}}}
|}
Từ đây có thể tính log(2):
{| class="wikitable"
|{{xpd0|#expr:ln2/ln10|gives={{!}}{{!}}}}
|}
|-
! abs
| 
|
{| class="wikitable"
|{{xpd0|#expr:abs-1.2|gives={{!}}{{!}}}}
|}
|-
! trunc
| 
|
{| class="wikitable"
|{{xpd0|#expr:trunc1.2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:trunc-1.2|gives={{!}}{{!}}}}
|}
|-
! floor
| 
|
{| class="wikitable"
|{{xpd0|#expr:floor1.2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:floor-1.2|gives={{!}}{{!}}}}
|}
|-
! ceil
| 
|
{| class="wikitable"
|{{xpd0|#expr:ceil1.2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:ceil-1.2|gives={{!}}{{!}}}}
|}
|-
! sin
| 
|
{| class="wikitable"
|{{xpd0|#expr:sin.1|gives={{!}}{{!}}}}
|}
Góc tính bằng độ, ví dụ 30°:
{| class="wikitable"
|{{xpd0|#expr:sin(30*pi/180)|gives={{!}}{{!}}}}
|}
|-
! cos
| 
|
{| class="wikitable"
|{{xpd0|#expr:cos.1|gives={{!}}{{!}}}}
|}
|-
! tan
| 
|
{| class="wikitable"
|{{xpd0|#expr:tan.1|gives={{!}}{{!}}}}
|}
|-
! asin
| 
|
{| class="wikitable"
|{{xpd0|#expr:asin.1|gives={{!}}{{!}}}}
|}
|-
! acos
| 
|
{| class="wikitable"
|{{xpd0|#expr:acos.1|gives={{!}}{{!}}}}
|}
|-
! atan
| 
|
{| class="wikitable"
|{{xpd0|#expr:atan.1|gives={{!}}{{!}}}}
|}
|-
! +
| Dấu '''<kbd>+</kbd>'''(dương), phép toán một ngôi 
|
{| class="wikitable"
|{{xpd0|#expr:+12|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:++12|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:+-12|gives={{!}}{{!}}}}
|}
|-
! -
| Dấu '''<kbd>-</kbd>''' (âm), phép toán một ngôi
|
{| class="wikitable"
|{{xpd0|#expr:-12|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-+12|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:--12|gives={{!}}{{!}}}}
|}
|-
! not
| phép toán một ngôi NOT, phép logic NOT (phép phủ định)
|
{| class="wikitable"
|{{xpd0|#expr:not 0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:not 1|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:not 2|gives={{!}}{{!}}}}
|}
|-
! ^
| Lũy thừa
|
{| class="wikitable"
|{{xpd0|#expr:2^7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:2^-7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:(-2)^7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:(-2)^8|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:2^1.2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:2^.5|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:(-2)^1.2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:(-2)^.5|gives={{!}}{{!}}}}
|}
|-
! *
| Phép nhân
|
{| class="wikitable"
|{{xpd0|#expr:30*7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:30*-7|gives={{!}}{{!}}}}
|}
|-
! /
|| Phép chia '''div'''
|
{| class="wikitable"
|{{xpd0|#expr:30/7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:30/-7|gives={{!}}{{!}}}}
|}
|-
! [[w:en:Division_%28mathematics%29#Division_of_integers|div]]
|| Phép chia, giống như '''/''',<br />không phải phép chia số nguyên
|
{| class="wikitable"
|{{xpd0|#expr:30 div 7|gives={{!}}{{!}}}} (đúng ra phải là 4)
|}
|-
! [[w:en:Modulo operation|mod]]
|"Modulo",phần dư của phép chia sau khi làm tròn (truncate) cả hai toán hạng thành số nguyên (toán tử PHP   [http://www.php.net/manual/en/language.operators.arithmetic.php %]).<br /><br />Cảnh báo rằng, '''div''' và '''mod''' khác với các ngôn ngữ lập trình. Lỗi này đã được vá (nhưng vẫn nên cẩn trọng), xem [[bugzilla:6068]]. 
|
{| class="wikitable"
|{{xpd0|#expr:30 mod 7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:30 mod -7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-30 mod 7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-30 mod -7|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-8 mod -3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-8 mod 2.9|gives={{!}}{{!}}}} (đúng ra phải là 2.6)
|-
|{{xpd0|#expr:-8 mod 3.2|gives={{!}}{{!}}}} (đúng ra phải là 1.6)
|-
|{{xpd0|#expr:8.9 mod 3|gives={{!}}{{!}}}} (đúng ra phải là 2.9)
|}
|-
! <kbd>+</kbd>
|| Phép cộng
|
{| class="wikitable"
|{{xpd0|#expr:30 + 7|gives={{!}}{{!}}}}
|}
|-
! <kbd>-</kbd>
|| Phép trừ
|
{| class="wikitable"
|{{xpd0|#expr:30 - 7|gives={{!}}{{!}}}}
|}
|-
! round
|| Làm tròn số ở bên trái theo số mũ của 1/10 được cho ở bên phải (hàm PHP [http://www.php.net/manual/en/function.round.php round])
|
{| class="wikitable"
|{{xpd0|#expr:4.2857 round 3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:4.2857 round 0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:42857 round -2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:4.5 round 0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-4.5 round 0|gives={{!}}{{!}}}}
|}
|-
! =
|| Bằng (số và logic)
|
{| class="wikitable"
|{{xpd0|#expr:3{{=}}03.0|gives={{!}}{{!}}}}
|}
|-
! &lt;&gt;
| Khác  ('''!=''')
|
{| class="wikitable"
|{{xpd0|#expr:3<>03.0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3<>4|gives={{!}}{{!}}}}
|}
|-
!| !=
|| Khác, giống như '''&lt;&gt;''', phép logic ''xor''
|
{| class="wikitable"
|{{xpd0|#expr:3!{{=}}03.0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3!{{=}}4|gives={{!}}{{!}}}}
|}
|-
! &lt;
|| Bé hơn
|
{| class="wikitable"
|{{xpd0|#expr:3<2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3<3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3<4|gives={{!}}{{!}}}}
|}
|-
! &gt;
|| Lớn hơn
|
{| class="wikitable"
|{{xpd0|#expr:3>2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3>3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3>4|gives={{!}}{{!}}}}
|}
|-
! &lt;=
| Bé hơn hoặc bằng
|
{| class="wikitable"
|{{xpd0|#expr:3<{{=}}2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3<{{=}}3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3<{{=}}4|gives={{!}}{{!}}}}
|}
|-
! &gt;=
| Lớn hơn hoặc bằng
|
{| class="wikitable"
|{{xpd0|#expr:3>{{=}}2|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3>{{=}}3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:3>{{=}}4|gives={{!}}{{!}}}}
|}
|-
! and
| Phép logic VÀ
|
{| class="wikitable"
|{{xpd0|#expr:3 and 4|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:0 and 3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-3 and 0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:0 and 0|gives={{!}}{{!}}}}
|}
|-
! or
| Phép logic HOẶC
|
{| class="wikitable"
|{{xpd0|#expr:3 or 4|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:0 or 3|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:-3 or 0|gives={{!}}{{!}}}}
|-
|{{xpd0|#expr:0 or 0|gives={{!}}{{!}}}}
|}
|}

==#if==

:<kbd><nowiki>{{#if:</nowiki> ''chuỗi kiểm tra'' | ''giá trị nếu '''đúng''''' | ''giá trị nếu '''sai''''' <nowiki>}}</nowiki></kbd>

Hàm này kiểm tra tham số thứ nhất có tồn tại (không rỗng) hay không. Hàm sẽ cho kết quả '''sai''' nếu như chuỗi kiểm tra rỗng hoặc chỉ chứa các kí tự trắng (như phím cách (khi nhấn phím SpaceBar), kí tự xuống dòng (khi nhấn phim Enter, v.v.).

:<kbd><nowiki>{{#if: | yes | no}}</nowiki></kbd> &rarr; '''{{#if: | yes | no}}'''
:<kbd><nowiki>{{#if: string | yes | no}}</nowiki></kbd> &rarr; '''{{#if: string | yes | no}}'''
:<kbd><nowiki>{{#if: &nbsp;&nbsp;&nbsp;&nbsp; | yes | no}}</nowiki></kbd> &rarr; '''{{#if:        | yes | no}}'''
:<kbd><nowiki>{{#if: </nowiki><br /><br /><br /><nowiki> | yes | no}}</nowiki></kbd> &rarr; '''{{#if: 


| yes | no}}'''

Chuỗi kiểm tra được hiểu là văn bản (chuỗi kí tự) thuần túy, vì thế biểu thức toán học không được tính:

:<kbd><nowiki>{{#if: 1==2 | yes | no }}</nowiki></kbd> &rarr; '''{{#if: 1==2 | yes | no}}'''
:<kbd><nowiki>{{#if: 0 | yes | no }}</nowiki></kbd> &rarr; '''{{#if: 0 | yes | no }}'''
Một trong hai hoặc cả hai giá trị trả về có thể được bỏ qua:

:<kbd><nowiki>{{#if: foo | yes }}</nowiki></kbd> &rarr; ''' {{#if: foo | yes }}'''
:<kbd><nowiki>{{#if: | yes }}</nowiki></kbd> &rarr; ''' {{#if: | yes }}'''
:<kbd><nowiki>{{#if: foo | | no}}</nowiki></kbd> &rarr; ''' {{#if: foo | | no}}'''

==#ifeq==
Hàm này so sánh hai chuỗi và xác định xem chúng có đồng nhất hay không.
:<kbd><nowiki>{{#ifeq:</nowiki> ''chuỗi 1'' <nowiki>|</nowiki> ''chuỗi 2'' <nowiki>|</nowiki> ''giá trị nếu đồng nhất'' <nowiki>|</nowiki> ''giá trị nếu khác nhau'' <nowiki>}}</nowiki></kbd>

Nếu cả hai chuỗi là các giá trị số hợp lệ, chúng sẽ được so sánh về số (toán học):

:<kbd><nowiki>{{#ifeq: 01 | 1 | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: 01 | 1 | yes | no}}'''
:<kbd><nowiki>{{#ifeq: 0 | -0 | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: 0 | -0 | yes | no}}'''

Còn nếu như so sánh văn bản, thì việc so sánh này có tính tới sự khác nhau giữa chữ viết hoa, viết thường:

:<kbd><nowiki>{{#ifeq: foo | bar | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: foo | bar | yes | no}}'''
:<kbd><nowiki>{{#ifeq: foo | Foo | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: foo | Foo | yes | no}}'''
:<kbd><nowiki>{{#ifeq: "01" | "1" | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: "01" | "1" | yes | no}}'''

{{warning|Nội dung bên trong các thẻ phân tích (ví dụ như <kbd><nowiki><nowiki></nowiki></kbd>) bị cắt ra trước khi các hàm phân tích được định giá trị, dẫn tới lỗi:
<kbd><nowiki>{{#ifeq: &lt;nowiki>foo&lt;/nowiki> | &lt;nowiki>foo&lt;/nowiki> | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: <nowiki>foo</nowiki> | <nowiki>foo</nowiki> | yes | no}} '''<br/>
<kbd><nowiki>{{#ifeq: &lt;math>foo&lt;/math> | &lt;math>foo&lt;/math> | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: <math>foo</math> | <math>foo</math> | yes | no}} '''<br/>
<kbd><nowiki>{{#ifeq: [[foo]] | [[foo]] | yes | no}}</nowiki></kbd> &rarr; '''{{#ifeq: [[foo]] | [[foo]] | yes | no}} '''<br/>
}}

== #iferror ==

<nowiki>{{#iferror</nowiki>: ''&lt;biểu thức>'' | ''lỗi'' | ''thành công'' }} cho ra ''lỗi'' nếu biểu thức gặp lỗi, tức là biểu thức bao gồm <nowiki><strong class="error"></nowiki>, do <code>#expr</code>, <code>#ifexpr</code>, <code>#time</code>, <code>#rel2abs</code>, v.v. Hàm này có ích trong việc bắt gặp chuỗi sai được cho vào. Chẳng hạn:

*<code><nowiki>{{#iferror:{{#expr:1+1}}|bad input|valid expression}}</nowiki></code> cho ra {{#iferror:{{#expr:1+1}}|bad input|valid expression}}
*<code><nowiki>{{#iferror:{{#expr:1+Z}}|bad input|valid expression}}</nowiki></code> cho ra {{#iferror:{{#expr:1+Z}}|bad input|valid expression}}

Không bắt buộc phải định hai tham số cuối cùng. Nếu tham số ''thành công'' không được định, kết quả của ''biểu thức'' được cho ra khi thành công. Nếu tham số ''lỗi'' cũng không được định, và nếu mã này gặp lỗi, thông báo lỗi không được cho ra, còn nếu không gặp lỗi, kết quả của ''biểu thức'' được cho ra.
*<code><nowiki>{{#iferror:{{#expr:1+1}}|bad input}}</nowiki></code> cho ra {{#iferror:{{#expr:1+1}}|bad input}}
*<code><nowiki>{{#iferror:{{#expr:1+Z}}|bad input}}</nowiki></code> cho ra {{#iferror:{{#expr:1+Z}}|bad input}}
*<code><nowiki>{{#iferror:{{#expr:1+1}}}}</nowiki></code> cho ra {{#iferror:{{#expr:1+1}}}}
*<code><nowiki>{{#iferror:{{#expr:1+Z}}}}</nowiki></code> cho ra {{#iferror:{{#expr:1+Z}}}}

Nên:
*<nowiki>{{#iferror:</nowiki>''mã nguồn''|''mã dự phòng''}} có nghĩa "cho ra kết quả của ''mã nguồn'' nếu đúng, hay không thì cho ra kết quả của ''mã dự phòng''".
*<nowiki>{{#iferror:</nowiki>''mã nguồn''}} có nghĩa "cho ra kết quả của ''mã nguồn'' nếu đúng".

==#ifexist==
Hàm này nhận vào một chuỗi, coi nó như một tiêu đề trang, và trả lại một trong hai giá trị tùy thuộc vào trang đó có tồn tại trên wiki nội bộ hay là không.

:<kbd><nowiki>{{#ifexist:</nowiki> ''tiêu đề trang'' | ''giá trị nếu tồn tại'' | ''giá trị nếu không tồn tại'' <nowiki>}}</nowiki></kbd>

Hàm sẽ định giá trị là <kbd>true</kbd> nếu như trang đó tồn tại, dù chúng có nội dung, là trang trắng rõ ràng (chứa dữ liệu meta như các đường liên kết thể loại hoặc [[Trợ giúp:Magic words]], nhưng nội dung không nhìn thấy được), hoặc là trống như trang đổi hướng. Chỉ đối với những trang liên kết đỏ hàm mới trả về giá trị false, bao gồm cả những trang đã từng tồn tại những hiện tại đã bị xóa.  

:<kbd><nowiki>{{#ifexist:</nowiki> {{FULLPAGENAME}} | tồn tại | không tồn tại <nowiki>}}</nowiki></kbd> &rarr; '''{{#ifexist: {{FULLPAGENAME}} | tồn tại | không tồn tại }}'''
:<kbd><nowiki>{{#ifexist:</nowiki> XXX{{FULLPAGENAME}}XXX | tồn tại | không tồn tại <nowiki>}}</nowiki></kbd> &rarr; '''{{#ifexist: XXX{{FULLPAGENAME}}XXX | tồn tại | không tồn tại }}'''

Hàm sẽ định giá trị true cho các [http://meta.wikimedia.org/wiki/Help:System_message tin nhắn hệ thống] được tùy chỉnh hóa, và cho các [http://www.mediawiki.org/wiki/Help:Special_pages trang đặc biệt] được xác định bằng phần mềm.  

:<kbd><nowiki>{{#ifexist:</nowiki> {{#special:Watchlist}} | tồn tại | không tồn tại <nowiki>}}</nowiki></kbd> &rarr; '''{{#ifexist: Special:Watchlist | tồn tại | không tồn tại }}'''
:<kbd><nowiki>{{#ifexist:</nowiki> {{#special:CheckUser}} | tồn tại | không tồn tại <nowiki>}}</nowiki></kbd> &rarr; {{#ifexist: Special:Checkuser | '''tồn tại''' (vì [http://www.mediawiki.org/wiki/Extension:Checkuser  đã được cài đặt vào wiki) | '''không tồn tại''' (vì {{mediawiki|Extension:Checkuser|CheckUser extension}} chưa được cài đặt ở wiki này) }}
:<kbd><nowiki>{{#ifexist: MediaWiki:Copyright | tồn tại | không tồn tại }}</nowiki></kbd> &rarr; {{#ifexist: MediaWiki:Copyright | '''tồn tại''' (vì [[{{ns:8}}:Copyright]] đã được tùy chỉnh hóa) | '''không tồn tại''' (vì [[{{ns:8}}:Copyright]] chưa được tùy chỉnh hóa) }}

<kbd>#ifexist:</kbd> được coi là một "hàm phân tích đắt giá", chỉ một số lượng giới hạn hàm này được chèn vào một trang bất kì nào đó (bao gồm cả những hàm bên trong các bản mẫu đã được chèn vào). Khi vượt quá giới hạn này, trang sẽ được xếp vào thể loại [[:Thể loại:{{MediaWiki:expensive-parserfunction-category}}]], và bất cứ hàm <kbd>#ifexist:</kbd> sau đó đều sẽ tự động trả về giá trị false, dù trang mục tiêu có tồn tại hay không.

Nếu một trang kiểm tra mục tiêu sử dụng <kbd>#ifexist:</kbd>, thì trang đó sẽ xuất hiện trong danh sách  [[{{#special:WhatLinksHere}}]] dành cho trang mục tiêu.  Vì vậy nếu mã <kbd><nowiki>{{#ifexist:Foo}}</nowiki></kbd> được chèn trực tiếp vào trang ({{FULLPAGENAME}}), [[{{#special:WhatLinksHere}}/Foo]] sẽ liệt kê {{FULLPAGENAME}}.

Trên những wiki sử dụng kho phương tiện chia sẻ, <kbd>#ifexist:</kbd> có thể được dùng để kiểm tra một tập tin đã được tải lên kho nhưng chưa lên wiki đó:<kbd><nowiki>{{#ifexist:</nowiki> {{ns:File}}:Example.png <nowiki>| tồn tại | không tồn tại }}</nowiki></kbd>  → '''{{#ifexist: {{ns:File}}:Example.png | exists | không tồn tại }}'''
:<kbd><nowiki>{{#ifexist:</nowiki> Image:Example.png <nowiki>| tồn tại | không tồn tại }}</nowiki></kbd> &rarr; '''{{#ifexist: Image:Example.png | exists | không tồn tại }}'''
:<kbd><nowiki>{{#ifexist:</nowiki> {{ns:-2}}:Example.png <nowiki>| tồn tại | không tồn tại }}</nowiki></kbd> &rarr; '''{{#ifexist: {{ns:-2}}:Example.png | tồn tại | không tồn tại }}'''
Nếu một trang miêu tả nôi bộ được tạo ra dành cho một tập tin, thì kết quả sẽ là '''tồn tại''' cho tất cả các mục kể trên.

== #ifexpr ==
Mã ifexpr khi bạn muốn có điều kiện là 0 tương ứng với sai và 1 tương ứng với đúng; thay vì dùng điều kiện chuỗi rỗng tương ứng với sai và không rỗng tương ứng với #if như trên
:<code><nowiki>{{</nowiki> #ifexpr: ''&lt;biểu thức>'' | ''&lt;chuỗi cho ra khi điều kiện đúng>'' | ''<chuỗi cho ra khi điều kiện sai>'' }}</code>

Ví dụ:
:<code><nowiki>{{#ifexpr: 3 > 1 | 3 > 1 | 3 ≤ 1 }}</nowiki></code>
cho ra
:{{#ifexpr: 3 > 1 | 3 > 1 | 3 ≤ 1 }}

== <del>#rand</del> ==
'''Lưu ý: Hàm này đã bị tắt và không còn hoạt động.'''

Hàm <code>rand</code> cho ra một số [[ngẫu nhiên đều]] trong dải được quy định bởi biến.

:<code><nowiki>{{</nowiki>#rand: ''&lt;giới hạn dưới>'' | ''&lt;giới hạn trên>'' }}</code>

==#rel2abs==
 <nowiki>{{ #rel2abs: lối }}
{{ #rel2abs: lối | lối gốc }}</nowiki>

== #switch ==
Hàm này so sánh một giá trị đầu vào với nhiều giá trị kiểm tra khác nhau, và trả về chuỗi kèm theo giá trị kiểm tra tương ứng nếu như một giá trị trùng khớp được tìm thấy.

 <nowiki>{{#switch:</nowiki> ''chuỗi được so sánh''
  | ''chuỗi kiểm tra<sup>1</sup>'' = ''kết quả<sup>1</sup>''
  | ''chuỗi kiểm tra<sup>2</sup>'' = ''kết quả<sup>2</sup>''
  | ''chuỗi kiểm tra<sup>3</sup>'' = ''kết quả<sup>3</sup>''
  | ''...''
  | ''chuỗi kiểm tra<sup>n</sup>'' = ''kết quả<sup>n</sup>''
  | ''kết quả mặc định''
 <nowiki>}}</nowiki>

<kbd>''kết quả mặc định''</kbd> được trả về nếu như không có <kbd>''chuỗi kiểm tra''</kbd> nào trùng khớp với <kbd>''chuỗi được so sánh''</kbd>:

<kbd><nowiki>{{#switch: test | foo = Foo | baz = Baz | Bar }}</nowiki></kbd> → '''{{#switch: test | foo = Foo | baz = Baz | Bar }}'''

Trong cú pháp này, kết quả mặc định phải là tham số sau cùng và không chứa dấu bằng. Ngoài ra, kết quả mặc định có thể được khai báo một cách rõ ràng bằng một <kbd>''chuỗi kiểm tra''</kbd> là "<kbd>#default</kbd>".

 <nowiki>{{#switch:</nowiki> ''chuỗi được so sánh''
  | ''chuỗi kiểm tra<sup>1</sup>'' = ''kết quả<sup>1</sup>''
  | ''chuỗi kiểm tra<sup>2</sup>'' = ''kết quả<sup>2</sup>''
  | ''chuỗi kiểm tra<sup>3</sup>'' = ''kết quả<sup>3</sup>''
  | ''...''
  | ''chuỗi kiểm tra<sup>n</sup>'' = ''kết quả<sup>n</sup>''
  | ''#default = kết quả mặc định''
 <nowiki>}}</nowiki>

Những kết quả mặc định đã khai báo theo cách này có thể được đặt vào bất cứ đâu trong hàm.

:<kbd><nowiki>{{#switch: test | foo = Foo | #default = Bar | baz = Baz }}</nowiki></kbd> &rarr; '''{{#switch: test | foo = Foo | #default = Bar | baz = Baz }}'''

:<kbd><nowiki>{{#switch: test | foo = Foo | baz = Baz }}</nowiki></kbd> &rarr; {{#switch: test | foo = Foo | baz = Baz }}

Các chuỗi kiểm tra có thể bị lướt qua (''fall through''), khi chúng '</kbd> trả về cùng một <kbd>''chuỗi kết quả''</kbd>. Điều này làm giảm bớt số lầṇ lặp. 

 <nowiki>{{#switch:</nowiki> ''chuỗi được so sánh''
  | ''chuỗi kiểm tra<sup>1</sup>'' = ''kết quả<sup>1</sup>''
  | ''chuỗi kiểm tra<sup>2</sup>'' 
  | ''chuỗi kiểm tra<sup>3</sup>'' 
  | ''chuỗi kiểm tra<sup>4</sup>'' = ''kết quả<sup>2</sup>''
  | ''chuỗi kiểm tra<sup>5</sup>'' = ''kết quả<sup>3</sup>''
  | ''chuỗi kiểm tra<sup>6</sup>'' 
  | ''chuỗi kiểm tra<sup>7</sup>'' = ''kết quả<sup>4</sup>''
  | ''#default = kết quả mặc định''
 <nowiki>}}</nowiki>

Ở đây tất cả các chuỗi kiểm tra 2, 3, và 4 đều trả về <kbd>''kết quả<sup>2</sup>''</kbd>; hai chuỗi kiểm tra 6, 7 đều trả về  <kbd>''kết quả<sup>4</sup>''</kbd>

Cũng như với hàm <kbd>[[##ifeq|#ifeq]]</kbd>, việc so sánh số được thực hiện nếu như chuỗi được so sánh và chuỗi kiểm tra đều là các số, và nếu như là văn bản thì so sánh tính đến sự khác biệt chữ hoa và chữ thường. <kbd>''Chuỗi kiểm tra''</kbd> có thể rỗng:
:<kbd><nowiki>{{#switch: | = Nothing | foo = Foo | Something }}</nowiki></kbd> &rarr; '''{{#switch: | = Nothing | foo = Foo | Something }}'''
Một khi đã tìm thấy một sự trùng khớp, những <kbd>''chuỗi kiểm tra''</kbd> sau nó bị lờ đi:
:<kbd><nowiki>{{#switch: b | f = Foo | b = Bar | b = Baz | }}</nowiki></kbd> &rarr; '''{{#switch: b | f = Foo | b = Bar | b = Baz | }}'''

'''Cảnh báo:''' Các "chuỗi kiểm tra" không được chứa các dấu bằng. Để làm việc này, chúng ta sẽ tạo một bản mẫu ở {{tl|{{=}}}}, trong bản mẫu này chỉ có duy nhất một dấu <kbd>=</kbd>. Sau đó, ta dùng bản mẫu vừa tạo như sau:

:<kbd><nowiki>{{#switch: 1=2</nowiki></kbd>
:<kbd><nowiki>&nbsp;| 1=2 = raw</nowiki></kbd>
:<kbd><nowiki>&nbsp;| 1&lt;nowiki>=&lt;/nowiki>2 = nowiki</nowiki></kbd>
:<kbd><nowiki>&nbsp;| 1&amp;#61;2 = html</nowiki></kbd>
:<kbd><nowiki>&nbsp;| 1{{=}}2 = template</nowiki></kbd>
:<kbd><nowiki>&nbsp;| foo }}</nowiki></kbd> &rarr; '''{{#switch: 1=2 | 1=2 = raw | 1<nowiki>=</nowiki>2 = nowiki | 1&#61;2 = html | 1{{=}}2 = template | foo}}'''

'''Chú ý''': Kiểm tra  [http://en.wikipedia.org/wiki/Template:NBA_color Template:NBA color]] để biết ví dụ thực tế ứng dụng hàm này. Một ví dụ phức tạp có thể tìm thấy ở [http://www.mediawiki.org/wiki/Template:Extension Template:Extension].

Nếu kết quả mặc định có dấu <code>=</code> thì phải bỏ <code>#default:</code> đằng trước kết quả đó.

Ví dụ:
:<nowiki>{{ #switch: +07 | 7 = Yes | 007 = Bond | No }}</nowiki> cho '''{{ #switch: +07 | 7 = Yes | 007 = Bond | No }}'''
 
:<nowiki>{{ #switch:"+07"|"7"= Yes |"007"= Bond | No }}</nowiki> cho '''{{ #switch:"+07"|"7"= Yes |"007"= Bond | No }}'''

== #time ==
Hàm <code>#time</code> để định dạng ngày tháng. Cú pháp hoặc:

:<code><nowiki>{{</nowiki>#time: ''định dạng'' }}</code>

hoặc:

:<code><nowiki>{{</nowiki>#time: ''định dạng'' | ''giờ'' }}</code>

{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
! Cú pháp
! Miêu tả
! Thí dụ
|--------------
| d
| Số ngày trong tháng, có số 0 đằng trước nếu cần.
| 04
|--------------
| D
| Từ viết tắt của ngày trong tuần, ít có dịch.
| Mon
|--------------
| j
| Số ngày trong tháng, không có số 0 đằng trước.
| 3
|--------------
| l
| Tên đầy đủ của ngày trong tuần, ít có dịch.
| Monday
|--------------
| F
| Tên tháng đầy đủ, thường được dịch.
| January
|--------------
| m
| Số tháng, có số 0 đằng trước nếu cần.
| 01 đến 12
|--------------
| M
| Từ viết tắt của tháng, thường được dịch.
| Jan
|--------------
| n
| Số tháng, không có số 0 đằng trước.
| 1 đến 12 
|--------------
| Y
| Năm có 4 chữ số.
| 2006
|--------------
| y
| Năm có 2 chữ số.
| 06
|--------------
| H
| Giờ trong ngày, có số 0 đằng trước nếu cần.
| 00 đến 23
|--------------
| i
| Phút, có số 0 đằng trước nếu cần.
| 00 đến 59
|--------------
| s
| Giây, có số 0 đằng trước nếu cần.
| 00 đến 59
|}

Các mã mở rộng không có trong cú pháp PHP:

{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
! Cú pháp
! Miêu tả
|--------------
| xn
| Cho ra số đằng sau là chữ số Ả Rập trong bộ mã ASCII, chẳng hạn trong tiếng Hindi, <code><nowiki>{{</nowiki>#time: H, xnH }}</code> cho ra <code>०६, 06</code>. 
|--------------
| xr
| Cho ra số đằng sau là chữ số Latinh.
|--------------
| xg
| Cho ra cách sở hữu của tên tháng trong những ngôn ngữ phân biệt cách sở hữu với cách danh sách.
|--------------
| xx
| Chữ "x" như vậy.
|}

===Thí dụ===
*<code><nowiki>{{#time:j F Y|-14 days}}</nowiki></code> cho ra <code>{{#time:j F Y|-14 days}}</code> (14 ngày trước đây).
*<code><nowiki>{{#time:H:i|+6 hours}}</nowiki></code> cho ra <code>{{#time:H:i|+6 hours}}</code> (6 giờ trễ đối với UTC)

== #titleparts ==
<nowiki>{{</nowiki>#titleparts:''&lt;tên trang>''|''&lt;số đoạn>''}} cho ra ''số đoạn'' đoạn của ''tên trang'', chia nhau bằng dấu gạch chéo, bắt đầu từ cấp cao nhất:

*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|0}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|0}}</code> (tên trang đầy đủ)
*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|1}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|1}}</code>
*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|2}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|2}}</code>
*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|3}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|3}}</code>
*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|4}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|4}}</code>

<nowiki>{{</nowiki>#titleparts:''&lt;tên trang>''|''&lt;số đoạn>''|''&lt;số của đoạn đầu>''}} cho ra ''số đoạn'' đoạn của ''tên trang'', chia nhau bằng dấu gạch chéo, bắt đầu từ đoạn thứ ''số của đoạn đầu'':

*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|2|2}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|2|2}}</code> (hai đoạn, bắt đầu từ đoạn thứ hai)

Tương tự:

*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|1|2}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|1|2}}</code>
*<code><nowiki>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|1|3}}</nowiki></code> cho ra <code>{{#titleparts:Wikipedia:Bài viết chọn lọc/2006/11|1|3}}</code>

==Sử dụng kết hợp==
Các hàm có thể được sử dụng kết hợp với nhau trong mã. Cách dùng này hữu ích khi chuỗi cho vào các hàm là kết quả tính toán bởi hàm khác.

Ví dụ mã sau không cho ra kết quả mong muốn:
:<code><nowiki>{{#ifexpr: (1+9)=10|1+9 bằng 10|1+9 không bằng 10}}</nowiki></code>
do "(1+9)=10", trong điều kiện, được hiểu là một chuỗi chứ không được tự động tính ra kết quả <code>đúng</code>. Thay vào đó chúng ta cần dùng mã kết hợp:
:<code><nowiki>{{#ifexpr: {{#expr: (1+9)=10}}|1+9 bằng 10|1+9 không bằng 10}}</nowiki></code>

Các chuỗi cũng có thể là kết quả của các [[Trợ giúp:Tiêu bản|tiêu bản]] hay [[Trợ giúp:Sửa đổi#Dùng biến số|biến hệ thống]]. Ví dụ:
:<code><nowiki>{{#ifexpr: {{#expr: {{THÁNGNÀY}} = 4}} |Tháng này là tháng 4|Tháng này không phải là tháng 4}}</nowiki></code>

==Tính một lần==
Chúng ta có thể cho hàm tính một lần và cho ra kết quả lưu trong mã nguồn của bài viết bằng cách dùng "subst" giống như với [[Wikipedia:Tiêu bản|tiêu bản]].

Ví dụ mã:
:<code><nowiki>{{subst:#expr: 2+2}}</nowiki></code>
Cho ra:
:'''4'''
Và kết quả 4 cũng là kết quả lưu trong mã nguồn của trang này.

==Dấu thập phân==
Lưu ý là phần mở rộng này hiện chỉ có dấu thập phân kiểu Mỹ: dấu phẩy dùng để phân tách phần ngàn, còn dấu chấm dùng để phân tách phần thập phân, tức là <code><nowiki>{{#expr: 22 / 7}}</nowiki></code> sẽ trở thành <code>3.14285714286</code>, chứ không <code>3,14285714286</code>. Có thể sử dụng {{tl|prettynum}} để đổi dấu chấm thành dấu phẩy.

== Tham khảo ==
{{Tham khảo}}

==Xem thêm==
{{Bàn giúp đỡ}}
*[[Trợ giúp:Toán học]]
*Tài liệu về [[m:ParserFunctions|ParserFunctions]] tại Meta

== Liên kết ngoài ==
* [http://mail.wikipedia.org/pipermail/wikitech-l/2006-April/thread.html#34685 Cuộc thảo luận về ParserFunctions trên danh sách thư wikitech-l]
* [http://mail.wikipedia.org/pipermail/wikitech-l/2006-April/034892.html ParserFunctions trial]
* [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ParserFunctions/Expr.php Expr.php]
* [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ParserFunctions/ParserFunctions.php ParserFunctions.php]
* [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ParserFunctions/ ParserFunctions in MediaWiki SVN]
* [[meta:Help:ParserFunctions]]

{{Offer help}}
{{Help navigation}}

[[Thể loại:Công cụ Wikipedia]]
[[Thể loại:Toán học]]
[[Thể loại:Dự án phát triển Wikipedia tiếng Việt]]