_zmsglobals.ZMSGlobals

ZMSGlobals.rand_int(n)

BESCHREIBUNG:
Generates a random number between 0 and n-1.

EINGABE-PARAMETER:
n: the basis of the value area

AUSGABE-PARAMETER:
int: the random number

  <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:
The function attaches the parameters stated by dict to the stated URL. The parameters are attached with & (resp. ?) to the URL according to url-encoded.
So e.g. url_append_params('http://host/path/index.html?lang=ger',{'par1':'val1','par2':'val2'}) delivers back the string 'http://host/path/index.html?lang=ger&par1=var1&par2=var2'.

EINGABE-PARAMETER:
url[url]: the URL
dict[dictionary]: the dictionary (Key/Value-pairs) of parameters

AUSGABE-PARAMETER:
url[url]: the URL enhanced with the stated parameters

 <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:
The function converts characters having a special meaning in URLs to HTML character-entities as decimal values.
So e.g. the string 'Hello World!' is convered to 'Hello%20World!'.

EINGABE-PARAMETER:
s: the URL-string

AUSGABE-PARAMETER:
string: the converted URL-string

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

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

BESCHREIBUNG:
Converts a string to a list. the list elements are seperated in the string by the stated delimiter (e.g. '\\n' for CR).

EINGABE-PARAMETER:
s[string]: the string
sep[string]='\\n': the delimiter of the list elements

AUSGABE-PARAMETER:
items[list]: list

ZMSGlobals.string_maxlen(s, maxlen=20)

BESCHREIBUNG:
Limits a string to the stated maximum length. Longer strings are cut and provided with "···".

EINGABE-PARAMETER:
s[string]: the string
maxlen[int]: the maximum length of the new string

AUSGABE-PARAMETER:
s[string]: the new string