utils
=================


















   .. js:function:: format(template, ...)

      Substitutes each occurence of the curly brackets enclosed number *n* with the with the
      *n+1* additional argument.

      :param String template: The template to use.
      :param String ...: The substitute.

      :return: The processed string.
      :rtype: String

      :example: format("foo {0}!", "bar") == "foo bar!"









   .. js:function:: uuid([length])

      Generates a UUID cosisting of upper and lower case characters and numbers at random.

      :param Number length: The length of the rquested UUID. Defaults to *10*.

      :return: The UUID.
      :rtype: String











   .. js:function:: capitalize(string)

      Capitalizes the first character of the given string with toUpperCase, hence is not
      resprecting the locale specific case definitions.

      :param String string: The input string.

      :return: The capitalized string.
      :rtype: String






   .. js:function:: callback(callback)

      Used for callback type checking and defaulting.

      :param Function callback: The callback to check. If it is not a function it will return
      an empty funciton.

      :return: A proper callback function, the provided one if it is valid.
      :rtype: Function






   .. js:function:: ROP(value)

      Return a property descriptor for a read-only property, which is sitll configurable and
      enumerable. It also containes the descriptor flag required for JClass property
      definitions.

      :param Any value: The value of the property.
      :return: A property descriptior that is JClass ready.
      :rtype: Object







   .. js:function:: setROP(object, name, value)

      Sets a read only (but still configurable and enumerable) property on the given object.

      :param Object object: The object to set the property on.
      :param String name: The name of the property.
      :param Any value: The value to set the property to.

      :return: The *value*.
      :rtype: Any








   .. js:function:: asyncRequire(path)

      Interfaces the a require calls into the async callback system.

      :param String path: The path to require.

      :return: A function that prefroms the require call and accepts an
      	callback(err, returnValue)
      :rtype: Function

















   .. js:function:: formatDate(data[, options])

   	Format s date object appropriately.

      :param Date date: The date to format.
      :param Object options: Further options for the formatting. (none supported yet)

      :return: The formatted date.
      :rtype: String












   .. js:function:: shortcutPP(definition[, os])

      Shortcut preprocessing

      :param String definition: The shortcuts definition.
      :param String os: The OS for which the shortcuts should be preprocessed. If not given,
        the value from *vispa.device.os* will be used.

      :return: The shortcut ready to be handles by the jQuery.Shortcuts plugin.
      :rtype: String