Help:Extension:ParserFunctions/tr

uzantısı, MediaWiki'de zaten mevcut olan ek olarak on bir yeni ayrıştırıcı işlev sunar. (Dize işleme için ek ayrıştırıcı işlevleri sağlamak üzere yapılandırılabilir; bu dize işlevleri belgelenmiştir.) Bu uzantı tarafından sağlanan tüm ayrıştırıcı işlevleri şu şekildedir:

#expr
Bu işlev, matematiksel bir ifadeyi değerlendirir ve hesaplanan değeri döndürür. Bu işlev,  işlevi aracılığıyla  olarak da kullanılabilir.



Kullanılabilir operatörler, öncelik sırasına göre sağda listelenir. Her operatörün işleviyle ilgili daha fazla ayrıntı için Help:Hesaplama sayfasına bakın. Döndürülen sonucun doğruluğu ve biçimi, vikiyi çalıştıran sunucunun işletim sistemine ve site dilinin sayı biçimine bağlı olarak değişecektir.

Boole cebri kullanılarak değerlendirme yapılırken, sıfır  olarak değerlendirilir ve pozitif veya negatif herhangi bir sıfır olmayan değer   olarak değerlendirilir:



Boş bir giriş ifadesi boş bir dize döndürür. Geçersiz ifadeler,  işlevi kullanılarak yakalanabilecek birkaç hata mesajından birini döndürür:



Bir sayıdan önce veya sonra toplama ve çıkarma işlenenlerinin sırası anlamlıdır ve hatalı girdi içeren bir işlenen yerine pozitif veya negatif bir değer olarak kabul edilebilir:



Sihirli kelimelerin çıkışını kullanıyorsanız, virgülleri kaldırmak ve sayıları çevirmek için bunları ham formatlamanız gerektiğini unutmayın. Örneğin,,   kullanılarak elde edilebilecek 0 ile istediğimiz yerde  ile sonuçlanır. Bu, özellikle sayıların çevrildiği bazı dillerde önemlidir. Örneğin, Bengalce'de, ৩০,০৬১ üretir.



Yuvarlama
Yuvarlaklar soldaki sayıyı bir kuvvete yükseltilmiş 1/10'un katına çıkarır, üs sağda verilen sayının kesik değerine eşittir.

Yukarı veya aşağı yuvarlamak için sırasıyla tekli  veya   kullanın.

Dizeler
İfadeler yalnızca sayı benzeri değerlerle çalışır, dizeleri veya karakterleri karşılaştıramazlar. Bunun yerine kullanılabilir.



#if
Bu işlev, bir test dizesini değerlendirir ve boş olup olmadığını belirler. Yalnızca boşluk içeren bir test dizisi boş olarak kabul edilir.





Bu işlev, ilk olarak ilk parametrenin boş olup olmadığını test eder. İlk parametre boş değilse, işlev ikinci bağımsız değişkeni görüntüler. İlk parametre boşsa veya yalnızca boşluk karakterleri (boşluklar, yeni satırlar vb.) içeriyorsa, üçüncü bağımsız değişkeni görüntüler.



Test dizesi her zaman saf metin olarak yorumlanır, bu nedenle matematiksel ifadeler değerlendirilmez:



Son parametre (false) atlanabilir:



İşlev iç içe olabilir. Bunu yapmak için, #if işlevinin bir parametresi yerine iç #if işlevini tam biçiminde yuvalayın. Yedi seviyeye kadar iç içe yerleştirme mümkündür, ancak bu vikiye veya bir bellek sınırına bağlı olabilir.

(Böylece parametrenin bir değeri yoksa, " " dizesi yerine boş bir dize olarak değerlendirilir.)
 * 1) if ifadenizde test dizesi olarak bir parametre de kullanabilirsiniz. Değişken adından sonra  (boru sembolü) eklediğinizden emin olmanız gerekir.



Bu ayrıştırıcı işlevine ilişkin daha fazla örnek için sayfasına bakın.

#ifeq
Bu ayrıştırıcı işlevi, iki giriş dizesini karşılaştırır, özdeş olup olmadıklarını belirler ve sonuca göre iki dizeden birini döndürür. Daha fazla karşılaştırma ve çıkış dizisi gerekiyorsa,  kullanmayı düşünün.



Her iki dizi de geçerli sayısal değerlerse, diziler sayısal olarak karşılaştırılır:



Aksi hâlde karşılaştırma metin olarak yapılır; bu karşılaştırma büyük/küçük harf duyarlıdır:


 * →  (yukarıdaki benzer örnekle tırnak işaretleri olmadan karşılaştırın)
 * →  (yukarıdaki benzer örnekle karşılaştırın, önce   geçerli bir sayı döndürür)
 * →  (yukarıdaki benzer örnekle tırnak işaretleri olmadan karşılaştırın)
 * →  (yukarıdaki benzer örnekle karşılaştırın, önce   geçerli bir sayı döndürür)

Pratik bir örnek olarak, kısa ve uzun olmak üzere iki standart zaman arasında seçim yapmak için ayrıştırıcıyı kullanan mevcut bir   düşünün. "short" dizesiyle karşılaştırılacak ilk giriş olarak parametreyi alır. Sıralama için bir konvansiyon yoktur, ancak parametre önce giderse okunması daha kolaydır. Şablon kodu şu şekilde tanımlanır:



aşağıdakiler ortaya çıkar:


 * → 20
 * → 40
 * → 40

#iferror
Bu işlev bir giriş dizesi alır ve iki sonuçtan birini döndürür; giriş dizesi,,   ve   gibi diğer ayrıştırıcı işlevler tarafından oluşturulan $hatalı bir HTML nesnesi içeriyorsa, döngüler ve özyinelemeler gibi şablon hataları varsa, işlev   olarak değerlendirilir, ve diğer "failsoft" ayrıştırıcı hataları.



Dönüş dizelerinden biri veya her ikisi atlanabilir. dizesi atlanırsa, hatalı değilse  döndürülür. dizesi de atlanırsa, bir hata durumunda boş bir dize döndürülür:


 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;

#ifexpr
Bu işlev, matematiksel bir ifadeyi değerlendirir ve sonucun boole değerine bağlı olarak iki dizeden birini döndürür:



girişi tam olarak yukarıdaki  için olduğu gibi değerlendirilir ve aynı operatörler kullanılabilir. Çıkış daha sonra bir boole ifadesi olarak değerlendirilir.

Boş bir giriş ifadesi  olarak değerlendirilir:



Yukarıda bahsedildiği gibi, sıfır  olarak değerlendirilir ve sıfır olmayan herhangi bir değer   olarak değerlendirilir, bu nedenle bu işlev yalnızca   ve   kullanan bir işleve eşdeğerdir:



boş veya yanlış bir giriş ifadesi dışında (bir hata mesajı boş bir dize olarak değerlendirilir; sıfıra eşit değildir, bu nedenle  alırız).



karşılama



Dönüş değerlerinden biri veya her ikisi atlanabilir; uygun dal boş bırakıldığında çıkış verilmez:



Boolean operators of equality or inequality operators are supported.



#ifexist
Bu işlev bir giriş dizesi alır, onu sayfa başlığı olarak yorumlar ve sayfanın yerel vikide bulunup bulunmadığına bağlı olarak iki değerden birini döndürür.



Sayfa mevcutsa, içerik barındırıyorsa, görünür şekilde boşsa (kategori bağlantıları veya gibi meta veriler içeriyorsa, ancak görünür bir içerik sayfası yoksa işlev   olarak değerlendirir.), boş veya bir  değerlendirilir. Sayfanın önceden var olduğu ancak silindiği de dahil olmak üzere, yalnızca kırmızı bağlantı verilen sayfalar  olarak değerlendirilir.



İşlev, özelleştirilmiş ve yazılım tarafından tanımlanan  için   olarak değerlendirilir.



Bir sayfa  kullanarak bir hedefi kontrol ederse, o sayfa hedef sayfanın  listesinde görünür. Dolayısıyla,  kodu bu sayfaya  canlı olarak dahil edildiyse, /Foo  sayfasını listeleyecektir.

Paylaşılan bir medya deposu kullanan wikilerde, bir dosyanın depoya yüklenip yüklenmediğini kontrol etmek için  kullanılabilir, ancak vikinin kendisine yüklenmez:



Dosya için yerel bir açıklama sayfası oluşturulmuşsa, yukarıdakilerin tümü için sonuç var olur.

vikiarası bağlantıları ile çalışmaz.

ifexist sınırları
"zengin bir ayrıştırıcı işlevi" olarak kabul edilir; herhangi bir sayfaya yalnızca sınırlı sayıda dahil edilebilir (yansıtılmış şablonların içindeki işlevler dahil). Bu sınır aşıldığında, hedef sayfa olsun veya olmasın, diğer  işlevleri otomatik olarak false döndürür ve sayfa Category: olarak sınıflandırılır. adı vikinizin içerik diline göre değişebilir.

Bazı kullanım durumlarında,  (var olmayan sayfalara bağlantı seçmek için) veya   (mevcut sayfalara bağlantılar seçmek için) seçicilerini kullanarak css ile ifexist efektini taklit etmek mümkündür. Ayrıca, tek bir sayfada kullanılabilecek zengin ayrıştırıcı işlevlerinin sayısı  tarafından kontrol edildiğinden, gerekirse LocalSettings.php içindeki limit de artırılabilir.

ifexist ve istenen sayfalar
Mevcut olmayan ve #ifexist kullanımı için test edilen bir sayfa İstenen Sayfalar'da yer alacaktır. Nedeni için ve bir geçici çözüm için w:Template:Linkless exists sayfasına bakın.

#rel2abs
Bu işlev, göreli bir dosya yolunu mutlak bir dosya yoluna dönüştürür.



girişi içinde aşağıdaki sözdizimi geçerlidir:


 * → mevcut düzey
 * → bir düzey yukarı çıkın
 * → /foo alt dizinine bir düzey aşağı inin

belirtilmezse, bunun yerine sayfanın tam sayfa adı kullanılacaktır:



veya  gibi geçersiz sözdizimi yoksayılır. İkiden fazla ardışık nokta izin verilmediğinden, ardışık ifadeleri ayırmak için aşağıdaki gibi diziler kullanılabilir:



#switch
Ayrıca bakınız: w:Help:Switch parser function

Bu işlev, bir giriş değerini birkaç test durumuyla karşılaştırır ve bir eşleşme bulunursa ilişkili bir dize döndürür.

Örnekler:



Kısmi dönüştürme etiketlerine sahip # switch, şablon kodlamasına aşina olmayan bir düzenleyicinin yapılandırılabilir öğeleri görüntülemesini ve düzenlemesini sağlayan bir yapılandırma dosyasını etkileyebilir.

Varsayılan
dizesi  ile eşleşmezse,   döndürülür:



Bu sözdiziminde, varsayılan sonuç son parametre olmalı ve ham eşittir işareti içermemelidir ( olmadan bir eşittir işareti). Varsa, büyük/küçük harf karşılaştırması olarak kabul edilecek ve hiçbir vaka eşleşmediyse hiçbir metin görüntülenmeyecektir. Bunun nedeni, varsayılan değerin tanımlanmamış olmasıdır (boş). Ancak bir durum eşleşirse, ilişkili dizesi döndürülür.



Alternatif olarak, varsayılan sonuç, bir  " " dizesiyle açıkça bildirilebilir.

Bu şekilde bildirilen varsayılan sonuçlar, işlev içinde herhangi bir yere yerleştirilebilir:



parametresi atlanırsa ve eşleşme olmazsa, hiçbir  döndürülmez:



Gruplandırma sonuçları
Birkaç  dizgisinin aynı   dizgisini döndürdüğü 'geçiş' değerlerine sahip olmak mümkündür. Bu, çoğaltmayı en aza indirir.

Burada 2, 3 ve 4 numaralı durumların tümü  döndürür; durum 6 ve 7'nin her ikisi de   döndürür. Yukarıdaki durumda son parametredeki " " atlanabilir.

Parametrelerle kullanın
İşlev, test dizesi olarak parametrelerle birlikte kullanılabilir. Bu durumda, boruyu parametre adından sonra yerleştirmek gerekli değildir, çünkü " " dizesi olarak bir büyük/küçük harf ayarlamayı seçmeniz pek olası değildir. (Bu, boru yoksa ve parametre yoksa veya bir değere sahipse parametrenin varsayılan olarak alacağı değerdir. sayfasına bakın.)



Yukarıdaki durumda,,   ile eşitse, işlev   döndürür. ile eşitse, işlev  döndürür. Parametre boşsa veya mevcut değilse, işlev  döndürür.

Yukarıdaki bölümde olduğu gibi, durumlar tek bir sonuç verecek şekilde birleştirilebilir.



Burada,  ,   veya   ile eşitse, işlev   döndürür. ile eşitse, işlev  döndürür. Parametre boşsa veya mevcut değilse, işlev  döndürür.

Ek olarak, test parametre değeri herhangi bir durumla eşleşmezse hiçbir şey döndürmek istemiyorsanız varsayılan sonuç atlanabilir.



Bu durumda, işlev,  mevcut olmadığı ve   veya   ile eşit olmadığı sürece boş bir dize döndürür; bu durumda sırasıyla   veya   döndürür.

Bu, varsayılan sonucu boş olarak bildirmekle aynı etkiye sahiptir.



Herhangi bir nedenle bir durumu " " olarak ayarlamaya karar verirseniz, parametre olmadığında veya bir değeri olmadığında işlev bu durumun sonucunu döndürür. İşlevin varsayılan sonucunu döndürmek için parametrenin var olması ve " " dizesinden başka bir değere sahip olması gerekir.


 * ( olmadığında veya boş olduğunda):
 * →  Foo 
 * ( " " değerine sahip olduğunda):
 * →  Bar 
 * (1$ " " değerine sahip olduğunda):
 * →  Foo 

Bu varsayımsal durumda, boruyu parametresine eklemeniz gerekir.

Karşılaştırma davranışı
ile olduğu gibi, karşılaştırma dizesi ve test edilen durum dizisinin her ikisi de sayısal ise karşılaştırma sayısal olarak yapılır; veya aksi takdirde büyük/küçük harfe duyarlı bir dize olarak:





Bir  dizesi boş olabilir:



Bir eşleşme bulunduğunda, sonraki  yoksayılır:



Ham eşittir işaretleri
"Case" dizeleri ham eşittir işaretleri içeremez. Bu sorunu çözmek için, tek bir eşittir işareti içeren bir = şablonu oluşturun:  veya eşittir işaretini HTML kodu   ile değiştirin.

Örnek:

#ifeq değiştirme
, genişleme derinliğini azaltmak için kullanılabilir.

Örneğin:



eşdeğerdir



yani derin yuvalama, doğrusal:

Öte yandan, anahtarın değiştirilmesi, her iki dalda iç içe geçmiş IF'ler için karmaşık/pratik olabilir (girinti alternatifleriyle gösterilir, her iki tarafta girintili), tam simetrik ağaç yapar:

#time
Bu ayrıştırıcı işlevi bir tarih ve/veya saat (Miladi takvimde) alır ve verilen sözdizimine göre biçimlendirir. Bir tarih/saat nesnesi belirtilebilir; varsayılan değer sihirli kelime  – diğer bir deyişle, sayfanın en son HTML'ye dönüştürüldüğü zaman.



Kabul edilen biçimlendirme kodlarının listesi sağdaki tabloda verilmiştir. Biçimlendirme dizesindeki tanınmayan herhangi bir karakter değiştirilmeden geçirilir; bu aynı zamanda boşluklar için de geçerlidir (sistemin kodları yorumlamak için bunlara ihtiyacı yoktur). Biçimlendirme dizesindeki karakterlerden kaçmanın da iki yolu vardır: Ek olarak,  digrafı tek bir değişmez "x" olarak yorumlanır.
 * 1) Bir biçimlendirme karakterinin ardından gelen bir ters eğik çizgi, tek bir değişmez karakter olarak yorumlanır
 * 2) Çift tırnak içine alınmış karakterler, değişmez karakterler olarak kabul edilir ve tırnak işaretleri kaldırılır.

Biçimlendirme kodları listesi gelişmeye devam ettikçe (yeni takvimlerin veya farklı şekilde hesaplanan ve biçimlendirilen yeni tarih alanlarının desteğiyle), iletilmesi gereken tüm değişmez karakterlerden (yalnızca şu anda biçimlendirme kodlarında kullanılan ASCII harflerini değil) kaçınmalısınız.

Ne yazık ki, şimdilik, ASCII tek tırnak işareti, hâlihazırda desteklenen ASCII çift tırnak işaretine değişmez metni işaretlemek için basit bir alternatif olarak ve ters eğik çizgiler (JSON, C, C++, PHP, JavaScript, Lua dahil olmak üzere birçok dil tarafından kullanılan dize sabitlerinde de kaçılması gerekir) tanınmamaktadır (örneğin, JSON, C, C++... içinde dize değerlerinin sınırlandırılması gibi diğer kullanımlar için çift tırnak zorunludur). Dolayısıyla, herhangi bir çifte alıntıyı ters eğik çizgi ile çıkarmadan gömemezsiniz (veya bunun yerine başka kıvırcık, açısal veya kare tırnak işaretleri kullanabilirsiniz).



PHP'nin strtotime işlevi tarafından kabul edilen herhangi bir biçimde olabilir. Hem mutlak (örneğin ) hem de göreceli (örneğin  ) zamanlar kabul edilir.


 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 

ISO 639-3 (?) içindeki, dizenin seçilen dilde görüntülenmesini sağlar



parametresi, tarih/saat nesnesinin yerel saat dilimine mi yoksa UTC'ye mi atıfta bulunduğunu belirtir.

Bu bir boole parametresidir: değeri, bağımsız değişkenin değeri kullanılarak belirlenir (dizenin boole değerlerine nasıl dönüştürüldüğüne ilişkin ayrıntılar için resmi PHP belgelerine bakın).

Ayrıntılar için aşağıdaki örneklere bakın:





Bir Unix zaman damgası hesapladıysanız, onu önceden bir  sembolü ekleyerek tarih hesaplamalarında kullanabilirsiniz.



Tam veya kısmi mutlak tarihler belirtilebilir; işlev, geçerli değerler kullanılarak belirtilmeyen tarihin bölümlerini "doldurur":



Dört basamaklı bir sayı her zaman bir yıl olarak yorumlanır, asla saat ve dakika olarak yorumlanmaz:



Altı basamaklı bir sayı, mümkünse saat, dakika ve saniye olarak yorumlanır, ancak aksi takdirde bir hata olarak yorumlanır (örneğin, bir yıl ve ay değil):


 * →  Giriş, yıl+ay kodu yerine zaman olarak değerlendirilir.
 * →  19:60:09 geçerli bir zaman olmasa da 196009, Eylül 1960 olarak yorumlanmaz.

İşlev, belirli bir miktarda tarih matematiği gerçekleştirir:



çağrılarının biçim dizelerinin toplam uzunluğu 6000 karakterle sınırlıdır.

Saat Dilimi sorunu
Bu #time ayrıştırıcı işlevinde (daha özel olarak PHP DateTime içinde), göreli zaman dilimi ofsetleri olarak tamsayı olmayan ögelerin iletilmesine izin vermeyen bir hata var. Bu sorun, EDT gibi bir saat dilimi kullanıldığında geçerli değildir. Örneğin:


 * &rarr;

Ancak Hindistan, UTC'den +5.5 saatlik bir zaman farkı üzerindedir ve bu nedenle kendi saat dilimini kullanmak, normal olarak göreli bir zaman dilimi farkının doğru hesaplanmasına izin vermez. İşte olanlar:


 * &rarr;

Bu soruna geçici bir çözüm bulmak için, zamanı şu şekilde dakikalara veya saniyelere dönüştürmeniz yeterlidir:


 * &rarr;
 * &rarr;

(Bu işlevin geliştiricisi Tim Starling, bu çözüm için tam sözdizimini sağladı.)

#timel
Bu işlev,  parametresi   olarak ayarlandığında   ile aynıdır, bu nedenle her zaman vikinin yerel saatini kullanır ( içinde ayarlandığı gibi).

İşlevin sözdizimi şöyledir:





Örneğin, aşağıdaki örneklere bakın:





#titleparts
Bu işlev, bir sayfa başlığını eğik çizgilere göre bölümlere ayırır ve ardından bu bölümlerden bazılarını çıkış olarak döndürür.



Döndürülecek segment sayısı parametresi belirtilmemişse, varsayılan olarak "0" olur ve döndürülecek ilk segment üzerinden (dahil) tüm segmentleri döndürür. döndürülecek ilk segment parametresi belirtilmemişse veya "0" ise varsayılan olarak "1" olur:


 * →  See also.
 * →  See also.

Her iki değer için de negatif değerler kabul edilir. döndürülecek segment sayısı parametresi için negatif değerler, dizenin sonundaki segmentleri etkin bir şekilde şerit eder. döndürülecek ilk segment için negatif değerler "bu segment sağdan sayılarak başla" anlamına gelir:


 * →  Dizenin sonundan bir segment çıkarır. Ayrıca bakınız.
 * →   Dizenin sonundan 4 parçayı da çıkarır
 * →   Dizenin sonundan 5 parça çıkarır (var olandan fazla)
 * →   Son segmenti döndürür. Ayrıca bakınız.
 * →   Dizenin sonundan bir segmenti çıkarır, ardından ikinci segmenti ve ötesini döndürür
 * →   İkinci son öğeden kopyalamaya başlayın; dizenin sonundan bir segmenti çıkarın

İşlemeden önce, sayfa adı parametresinin kodu HTML ile çözülür: eğer bazı standart HTML karakter varlıkları içeriyorsa, bunlar düz karakterlere dönüştürüleceklerdir (UTF-8 ile dahili olarak kodlanmıştır, yani bu ayrıştırıcı işlevini kullanan MediaWiki kaynak sayfasındakiyle aynı kodlama).


 * Örneğin, sayfa adı içindeki herhangi bir,   veya   oluşumu   ile değiştirilecektir.
 * HTML'den düz metne başka bir dönüşüm gerçekleştirilmez, bu nedenle HTML etiketleri, sayfa başlıklarında geçersiz olsalar bile bu ilk adımda olduğu gibi bırakılır.

Ardından, kodu çözülen sayfa adı mümkün olduğunca MediaWiki tarafından desteklenen standart bir sayfa başlığına standart hâle getirilir:


 * 1) Tüm alt çizgiler otomatik olarak boşluklarla değiştirilir:
 * →  Orijinaldeki alt çizgiye rağmen bah_boo değil.
 * 1) Dize en fazla 25 kez bölünür; daha fazla eğik çizgi yok sayılır ve 25. öğe dizenin geri kalanını içerecektir. Dize ayrıca sayfa başlığı olarak kabul edildiğinden 255 karakterle sınırlıdır:
 * Herhangi bir nedenle bu işlevi sınırına kadar zorlamanız gerekiyorsa, pek olası olmasa da, işlev çağrılarını iç içe geçirerek 25 bölme sınırını atlamak mümkündür:
 * 1) Son olarak, ilk alt dize yerel vikinin büyük harf kullanımı ayarlarına göre büyük harfle yazılır (bu alt dize de yerel bir ad alanı adıyla başlıyorsa, bu ad alanı adı da normalleştirilir).
 * 1) Son olarak, ilk alt dize yerel vikinin büyük harf kullanımı ayarlarına göre büyük harfle yazılır (bu alt dize de yerel bir ad alanı adıyla başlıyorsa, bu ad alanı adı da normalleştirilir).
 * 1) Son olarak, ilk alt dize yerel vikinin büyük harf kullanımı ayarlarına göre büyük harfle yazılır (bu alt dize de yerel bir ad alanı adıyla başlıyorsa, bu ad alanı adı da normalleştirilir).

{{Warning|1= Certain characters that are illegal in a page title will cause #titleparts to not parse the string:


 * → {{#titleparts: {one/two} | 1 | 1 }}. Does not produce the expected: {one
 * → {{#titleparts: page/123 | 1 | 2 }}. Does not work because brackets are illegal in page titles and this parser function does not process links embedded in its input pagename parameter, even when they use the MediaWiki syntax, or any other HTML or MediaWiki tags.
 * → "{{#titleparts: red/#00FF00/blue| 1 | 3 }}". Does not work because "#" is also illegal in page titles.

}}

StringFunctions
All of these functions are integrated from the StringFunctions extension, but are only available if an administrator sets   in.

All of these functions operate in O(n) time complexity, making them safe against DoS attacks.

#len
The #len function returns the length of the given string. The syntax is:

The return value is always a number of characters in the source string (after expansions of template invocations, but before conversion to HTML). If no string is specified, the return value is zero.

#pos
The #pos function returns the position of a given search term within the string. The syntax is:

The offset parameter, if specified, tells a starting position where this function should begin searching.

If the search term is found, the return value is a zero-based integer of the first position within the string.

If the search term is not found, the function returns an empty string.

#rpos
The #rpos function returns the last position of a given search term within the string. The syntax is:

If the search term is found, the return value is a zero-based integer of its last position within the string.

If the search term is not found, the function returns -1.

#sub
The #sub function returns a substring from the given string. The syntax is:

The start parameter, if positive (or zero), specifies a zero-based index of the first character to be returned.

Example: returns.

returns.

If the start parameter is negative, it specifies how many characters from the end should be returned.

Example: returns.

The length parameter, if present and positive, specifies the maximum length of the returned string.

Example: returns.

If the length parameter is negative, it specifies how many characters will be omitted from the end of the string.

Example: returns.

If the start parameter is negative, it specifies how many characters from the end should be returned. The length parameter, if present and positive, specifies the maximum length of the returned string from the starting point.

Example: returns.

#count
The #count function returns the number of times a given substring appears within the provided text.

#replace
The #replace function returns the given string with all occurrences of a search term replaced with a replacement term.

If the search term is unspecified or empty, a single space will be searched for.

If the replacement term is unspecified or empty, all occurrences of the search term will be removed from the string.

Currently the syntax doesn't provide a switch to toggle case-sensitivity setting. But you may make use of magic words of formatting as a workaround. (e.g. your_string_here ) For example, if you want to remove the word "Category:" from the string regardless of its case, you may type:
 * Case-insensitive replace :

But the disadvantage is that the output will become all lower-case. If you want to keep the casing after replacement, you have to use multiple nesting levels (i.e. multiple replace calls) to achieve the same thing.

#explode
The #explode function splits the given string into pieces and then returns one of the pieces. The syntax is:

The delimiter parameter specifies a string to be used to divide the string into pieces. This delimiter string is then not part of any piece, and when two delimiter strings are next to each other, they create an empty piece between them. If this parameter is not specified, a single space is used. The limit parameter is available in ParserFunctions only, not the standalone StringFunctions version, and allows you to limit the number of parts returned, with all remaining text included in the final part.

The position parameter specifies which piece is to be returned. Pieces are counted from 0. If this parameter is not specified, the first piece is used (piece with number 0). When a negative value is used as position, the pieces are counted from the end. In this case, piece number -1 means the last piece. Examples:


 * returns
 * returns
 * returns
 * returns

The return value is the position-th piece. If there are fewer pieces than the position specifies, an empty string is returned.

#urldecode
converts the escape characters from an 'URL encoded' string back to readable text. The syntax is:

Notes:
 * This function works by directly exposing PHP's urldecode function.
 * A character-code-reference can be found at www.w3schools.com.
 * The opposite,, has been integrated into MediaWiki as of version 1.18; for examples, see.
 * urldecode was merged from Stringfunctions in 2010, by commit 1b75afd18d3695bdb6ffbfccd0e4aec064785363

Limits
This module defines three global settings:


 * $wgStringFunctionsLimitSearch
 * $wgStringFunctionsLimitReplace
 * $wgStringFunctionsLimitPad

These are used to limit some parameters of some functions to ensure the functions operate in O(n) time complexity, and are therefore safe against DoS attacks.

$wgStringFunctionsLimitSearch
This setting is used by #pos, #rpos, #replace, and #explode. All these functions search for a substring in a larger string while they operate, which can run in O(n*m) and therefore make the software more vulnerable to DoS attacks. By setting this value to a specific small number, the time complexity is decreased to O(n).

This setting limits the maximum allowed length of the string being searched for.

The default value is 30 multibyte characters.

$wgStringFunctionsLimitReplace
This setting is used by #replace. This function replaces all occurrences of one string for another, which can be used to quickly generate very large amounts of data, and therefore makes the software more vulnerable to DoS attacks. This setting limits the maximum allowed length of the replacing string.

The default value is 30 multibyte characters.

Substitution
Parser functions can be substituted by prefixing the hash character with :


 * → the code   will be inserted in the wikitext since the page exists.

Substitution does not work within ; you can use &hellip;  for this purpose.

Redirects
Especially   could be handy in  to pages including dates, but this does not work.

Escaping pipe characters in tables
Parser functions will mangle syntax and pipe characters, treating all the raw pipe characters as parameter dividers. To avoid this, most wikis used a template    :! with its contents only a raw pipe character, since MW 1.24 a  replaced this kludge. This 'hides' the pipe from the MediaWiki parser, ensuring that it is not considered until after all the templates and variables on a page have been expanded. It will then be interpreted as a table row or column separator. Alternatively, raw HTML table syntax can be used, although this is less intuitive and more error-prone.

You can also escape the pipe character for display as a plain, uninterpreted character using an HTML entity:.

Stripping whitespace
Whitespace, including newlines, tabs, and spaces, is stripped from the beginning and end of all the parameters of these parser functions. If this is not desirable, comparison of strings can be done after putting them in quotation marks.



To prevent the trimming of then and else parts, see m:Template:If. Some people achieve this by using &lt; &gt;  &lt; /nowiki &gt; instead of spaces.


 * → foofoo
 * → foofoo

However, this method can be used to render a single whitespace character only, since the parser squeezes multiple whitespace characters in a row into one.




 * || → || foofoo 
 * }

In this example, the  style is used to force the whitespace to be preserved by the browser, but even with it the spaces are not shown. This happens because the spaces are stripped by the software, before being sent to the browser.

It is possible to workaround this behavior replacing whitespaces with  (breakable space) or   (non-breakable space), since they are not modified by the software:


 * →  foofoo 
 * → foofoo