602SQL-┌plnß dokumentace Index   Tisk  

Funkce ve v²razech (WBIK)

Formßt:

funkce(v²raz)

Nßsledujφcφ funkce lze volat ve v²razech v Üablonßch a konektorech.

StrLength - vrßtφ dΘlku °et∞zce

Str2WBConstStr - vrßtφ °et∞zec ve tvaru vhodnΘm pro 602SQL

Str2URLStr - vrßtφ °et∞zec ve tvaru vhodnΘm pro pou₧itφ v URL

Str2HTMLConstStr - vrßtφ °et∞zec ve tvaru pou₧itelnΘm v HTML textu

ToString - p°evede ·daj na vstupu na °et∞zec podle zadanΘ specifikace IK

FormatStr - provede konverzi zadanΘho parametru na °et∞zec podle formßtovacφho vzoru.

GetURLPart - vrßtφ Φßst zadanΘ URL adresy

GetVersion - vrßtφ verzi WBIK

function StrLength (vstup : string) : integer

V²znam:

Funkce vrßtφ dΘlku stringu vstup. Pokud je vstup rovno NULL, pak vrßtφ 0.

function Str2WBConstStr(vstup : string) : string

V²znam:

Funkce p°evßdφ vstupnφ parametr na string, kter² obsahuje konstantnφ string podle SQL i vnit°nφho jazyka 602SQL. Provede se toto:

function Str2URLStr(vstup : string [,up°esn∞nφ : integer]) : string

V²znam:

Je-li up°esn∞nφ vynechßno nebo 0, funkce p°evßdφ vstupnφ parametr na string zak≤dovan² tak, aby se mohl stßt souΦßstφ URL, tj. beze zm∞ny z∙stanou znaky anglickΘ abecedy, Φφslice a znaky - _ . ! ~ * ' ( ). Ostatnφ znaky se zak≤dujφ pomocφ %hh - za procenty nßsleduje ASCII k≤d znaku v hexadecimßlnφm vyjßd°enφ.

Je-li up°esn∞nφ rovno 1, zak≤dujφ se vÜechny znaky krom∞ anglickΘ abecedy, Φφslic a podtr₧φtka ( _ ).

P°φklad:

Sestavenφ parametr∙ URL v konektoru:

DeclareVar: searchwbc='namesearch'
DeclareVar: searchwbcparams='name='+Str2URLStr(name)
#if exists this_topic_only
SetVar: searchwbcparams=searchwbcparams+'&this_topic_only=TRUE&tid=%tid%'
#endif
function Str2HTMLConstStr(vstup : string) : string

V²znam:

P°evede vstup na °et∞zec, ve kterΘm jsou znaky ", <, >, & nahrazeny zßpisy &quot;, &lt;, &gt;, &amp;. V²sledn² string je vhodn² pro jeho uvedenφ nap°. v parametru VALUE tagu <INPUT> a ve vÜech ostatnφch p°φpadech, kde je t°eba uvΘst konstantnφ string podle pravidel jazyka HTML.

P°φklad:

<form method="post" action="<%wb_url%>/cz_help_finder.wbc">
  <input type="hidden" name="start" value="0">
  Hledej: <input type="text" name="query" size="30" maxlength="254"<%if exists query%> value="<%Str2HTMLConstStr(query)%>"<%endif%>>
  <input type="submit" value="OK">
</form>
function ToString(vstup : libovoln²_typ [,up°esn∞nφ : integer] ) : string

V²znam:

Funkce p°evßdφ vstup na °et∞zec, p°iΦem₧ pou₧ije up°esn∞nφ citace (ve stejnΘm v²znamu jako v citaci), up°esn∞nφ je nepovinn² parametr.

P°φklad:

je t°eba do URL zakomponovat hodnotu typu real v ·Φetnφm formßtu:

<A href="...<%Str2URLStr(ToString(hodnota_money,-102))%>...">
function FormatStr(string,...):string

V²znam:

Funkce provede konverzi zadanΘho parametru na °et∞zec podle formßtovacφho vzoru.

Funkce mß prvnφ parametr formßtovacφ °et∞zec typu string a za nφm nßsleduje libovoln² (i nulov²) poΦet parametr∙ libovolnΘho typu. V²sledkem funkce je °et∞zec vznikl² z formßtovacφho °et∞zce a dalÜφch parametr∙ podle nßsledujφcφch pravidel:

- znak r∙zn² od % bude zkopφrovßn z formßtovacφho °et∞zce do v²stupnφho °et∞zce

- dvojice znak∙ %% z formßtovacφho °et∞zce bude ve v²stupnφm °et∞zci nahrazena jednφm znakem %

- pod°et∞zec %s formßtovacφho °et∞zce bude nahrazen ve v²stupnφm °et∞zci textov²m zßpisem hodnoty parametru funkce, p°iΦem₧ p°i prvnφm v²skytu %s bude pou₧it prvnφ parametr nßsledujφcφ za formßtovacφm °et∞zcem, p°i druhΘm v²skytu %s druh² parametr atd.

- pod°et∞zec %<Φφslo>s bude nahrazen textov²m zßpisem hodnoty odpovφdajφcφho parametru, p°iΦem₧ p°i citaci hodnoty bude pou₧ito up°esn∞nφ citace <Φφslo> pokud je mφsto <Φφsla> uvedena hv∞zdiΦka (tj. %*s), vyhodnotφ se odpovφdajφcφ parametr volßnφ funkce, kter² musφ b²t celoΦφselnΘho typu, a jeho hodnota se pou₧ije jako up°esn∞nφ citace nßsledujφcφho parametru volßnφ funkce.

P°φklady:

FormatStr("ab%%cd%sefgh","ab")="ab%cdabefgh"
FormatStr("%s-%s",58,62.14)="58-62.14"
FormatStr("%3s",1.1.2001)="1. leden 2001"
FormatStr("%*s",1,27.12.1998 12:45:56)="27.prosinec 1998 12:45:56"
function GetURLPart(url:string;part:integer):string

V²znam:

Funkce vrßtφ Φßst adresy URL, kterΘ je zadanß prvnφm parametrem. OznaΦenφ (Φφslo) Φßsti URL, kterou mß funkce vrßtit, je ve druhΘm parametru.

Bu∩ URL v nßsledujφcφm tvaru:

url=http://username:password@www.server.cz/dir1/dir2/filename.ext?query=123#fragment
oznaΦenφ Φßsti nßvratovß hodnota funkce
1 http
2 username
3 password
4 www.server.cz
5 /dir1/dir2/
6 filename.ext
7 ?query=123
8 #fragment
ostatnφ NULL

Pokud po₧adovanß Φßst URL nenφ v URL obsa₧ena, nßvratovß hodnota je NULL.

function GetVersion(param:string):integer

V²znam:

Funkce vrßtφ verzi Internet Klienta.

Parametr string m∙₧e b²t jedna z nßsledujφcφch hodnot: "major" "minor" "patch". Funkce vracφ Φφslici z Φφsla verze Internet klienta, kterß odpovφdß zadanΘ hodnot∞ stringovΘho parametru funkce, nebo -1 p°i chyb∞ (tzn. pokud je hodnota stringovΘho parametru funkce jinß ne₧ povolenΘ hodnoty).

P°φklad pro verzi 7.0.6:

GetVersion("major")=7
GetVersion("minor")=0
GetVersion("patch")=6