_zmsglobals.ZMSGlobals

ZMSGlobals.rand_int(n)

BESCHREIBUNG:
Generiert eine Zufallszahl zwischen 0 und n-1.

EINGABE-PARAMETER:
n: die Basis des Wertebereichs

AUSGABE-PARAMETER:
int: die Zufallszahl

  <dtml-let imgs="objectValues(['Image'])">
    <img src="<dtml-var "imgs[rand_int(_.len(imgs))].absolute_url()">
  </dtml-let>

_zmsglobals.url_append_params(url, dict)

BESCHREIBUNG:
Die Funktion hängt die durch dict angegebenen Parameter an die angegebene URL. Die Parameter werden mit & (bzw. ?) an die URL entsprechend url-encoded angehängt.
So liefert z.B. url_append_params('http://host/path/index.html?lang=ger',{'par1':'val1','par2':'val2'}) die Zeichenkette 'http://host/path/index.html?lang=ger&par1=var1&par2=var2' zurück.

EINGABE-PARAMETER:
url[url]: die URL
dict[dictionary]: das Dictionary (Key/Value-Paare) von Parametern

AUSGABE-PARAMETER:
url[url]: die um die angegebenen Parametern erweiterte URL

 <dtml-let dt="ZopeTime()">
  <a href="<dtml-var "url_append_params(
     getHref2IndexHtml(REQUEST),
     {'year:int':dt.year()
     ,'month:int':dt.month()
     ,'day:int':dt.day()
    })">">
   <dtml-var "getTitle(REQUEST)">
  </a>
 </dtml-let>

  <a href="<dtml-var "url_append_params(
     URL,
     {'auth_user':_.str(AUTHENTICATED_USER)
    })">">
   Edit profile
  </a>

ZMSGlobals.url_quote(s)

BESCHREIBUNG:
Die Funktion konvertiert Zeichen die in URLs eine spezielle Bedeutung haben in HTML Zeichen-Entitäten als Dezimalwerte.
So wird beispielsweise die Zeichenkette 'Hello World!' in 'Hello%20World!' konvertiert.

EINGABE-PARAMETER:
s: die URL-Zeichenkette

AUSGABE-PARAMETER:
string: die konvertierte URL-Zeichenkette

  <a href="index_html?title=<dtml-var "url_quote(getObjProperty('title',REQUEST))">">

ZMSGlobals.string_list(s, sep='\\n')

BESCHREIBUNG:
Konvertiert eine Zeichenkette in eine Liste. Die Listenelemente sind in der Zeichenkette durch den angegebenen Delimiter getrennt (z.B. '\\n' für CR).

EINGABE-PARAMETER:
s[string]: die Zeichenkette
sep[string]='\\n': der Delimiter der Listenelemente

AUSGABE-PARAMETER:
items[list]: Liste

ZMSGlobals.string_maxlen(s, maxlen=20)

BESCHREIBUNG:
Begrenzt eine Zeichenkette auf die angegeben maximale Länge. Längere Zeichenketten werden abgeschnitten und mit "···" versehen.

EINGABE-PARAMETER:
s[string]: die Zeichenkette
maxlen[int]: die maximale Länge der neuen Zeichenkette

AUSGABE-PARAMETER:
s[string]: die neue Zeichenkette