nextcloud / server

lib/public/IUserBackend.php

Indentation +6 added lines, -6 removed lines

@@ -38,11 +38,11 @@
  */
 interface IUserBackend {
 
-	/**
-	 * Backend name to be shown in user management
-	 * @return string the name of the backend to be shown
-	 * @since 8.0.0
-	 */
-	public function getBackendName();
+    /**
+     * Backend name to be shown in user management
+     * @return string the name of the backend to be shown
+     * @since 8.0.0
+     */
+    public function getBackendName();
 
 }

lib/public/ITags.php

Indentation +174 added lines, -174 removed lines

@@ -50,179 +50,179 @@
 
 interface ITags {
 
-	/**
-	 * Check if any tags are saved for this type and user.
-	 *
-	 * @return boolean
-	 * @since 6.0.0
-	 */
-	public function isEmpty();
-
-	/**
-	 * Returns an array mapping a given tag's properties to its values:
-	 * ['id' => 0, 'name' = 'Tag', 'owner' = 'User', 'type' => 'tagtype']
-	 *
-	 * @param string $id The ID of the tag that is going to be mapped
-	 * @return array|false
-	 * @since 8.0.0
-	 */
-	public function getTag($id);
-
-	/**
-	 * Get the tags for a specific user.
-	 *
-	 * This returns an array with id/name maps:
-	 * [
-	 * 	['id' => 0, 'name' = 'First tag'],
-	 * 	['id' => 1, 'name' = 'Second tag'],
-	 * ]
-	 *
-	 * @return array
-	 * @since 6.0.0
-	 */
-	public function getTags();
-
-	/**
-	 * Get a list of tags for the given item ids.
-	 *
-	 * This returns an array with object id / tag names:
-	 * [
-	 *   1 => array('First tag', 'Second tag'),
-	 *   2 => array('Second tag'),
-	 *   3 => array('Second tag', 'Third tag'),
-	 * ]
-	 *
-	 * @param array $objIds item ids
-	 * @return array|boolean with object id as key and an array
-	 * of tag names as value or false if an error occurred
-	 * @since 8.0.0
-	 */
-	public function getTagsForObjects(array $objIds);
-
-	/**
-	 * Get a list of items tagged with $tag.
-	 *
-	 * Throws an exception if the tag could not be found.
-	 *
-	 * @param string|integer $tag Tag id or name.
-	 * @return array|false An array of object ids or false on error.
-	 * @since 6.0.0
-	 */
-	public function getIdsForTag($tag);
-
-	/**
-	 * Checks whether a tag is already saved.
-	 *
-	 * @param string $name The name to check for.
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function hasTag($name);
-
-	/**
-	 * Checks whether a tag is saved for the given user,
-	 * disregarding the ones shared with him or her.
-	 *
-	 * @param string $name The tag name to check for.
-	 * @param string $user The user whose tags are to be checked.
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function userHasTag($name, $user);
-
-	/**
-	 * Add a new tag.
-	 *
-	 * @param string $name A string with a name of the tag
-	 * @return int|false the id of the added tag or false if it already exists.
-	 * @since 6.0.0
-	 */
-	public function add($name);
-
-	/**
-	 * Rename tag.
-	 *
-	 * @param string|integer $from The name or ID of the existing tag
-	 * @param string $to The new name of the tag.
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function rename($from, $to);
-
-	/**
-	 * Add a list of new tags.
-	 *
-	 * @param string[] $names A string with a name or an array of strings containing
-	 * the name(s) of the to add.
-	 * @param bool $sync When true, save the tags
-	 * @param int|null $id int Optional object id to add to this|these tag(s)
-	 * @return bool Returns false on error.
-	 * @since 6.0.0
-	 */
-	public function addMultiple($names, $sync=false, $id = null);
-
-	/**
-	 * Delete tag/object relations from the db
-	 *
-	 * @param array $ids The ids of the objects
-	 * @return boolean Returns false on error.
-	 * @since 6.0.0
-	 */
-	public function purgeObjects(array $ids);
-
-	/**
-	 * Get favorites for an object type
-	 *
-	 * @return array|false An array of object ids.
-	 * @since 6.0.0
-	 */
-	public function getFavorites();
-
-	/**
-	 * Add an object to favorites
-	 *
-	 * @param int $objid The id of the object
-	 * @return boolean
-	 * @since 6.0.0
-	 */
-	public function addToFavorites($objid);
-
-	/**
-	 * Remove an object from favorites
-	 *
-	 * @param int $objid The id of the object
-	 * @return boolean
-	 * @since 6.0.0
-	 */
-	public function removeFromFavorites($objid);
-
-	/**
-	 * Creates a tag/object relation.
-	 *
-	 * @param int $objid The id of the object
-	 * @param string $tag The id or name of the tag
-	 * @return boolean Returns false on database error.
-	 * @since 6.0.0
-	 */
-	public function tagAs($objid, $tag);
-
-	/**
-	 * Delete single tag/object relation from the db
-	 *
-	 * @param int $objid The id of the object
-	 * @param string $tag The id or name of the tag
-	 * @return boolean
-	 * @since 6.0.0
-	 */
-	public function unTag($objid, $tag);
-
-	/**
-	 * Delete tags from the database
-	 *
-	 * @param string[]|integer[] $names An array of tags (names or IDs) to delete
-	 * @return bool Returns false on error
-	 * @since 6.0.0
-	 */
-	public function delete($names);
+    /**
+     * Check if any tags are saved for this type and user.
+     *
+     * @return boolean
+     * @since 6.0.0
+     */
+    public function isEmpty();
+
+    /**
+     * Returns an array mapping a given tag's properties to its values:
+     * ['id' => 0, 'name' = 'Tag', 'owner' = 'User', 'type' => 'tagtype']
+     *
+     * @param string $id The ID of the tag that is going to be mapped
+     * @return array|false
+     * @since 8.0.0
+     */
+    public function getTag($id);
+
+    /**
+     * Get the tags for a specific user.
+     *
+     * This returns an array with id/name maps:
+     * [
+     * 	['id' => 0, 'name' = 'First tag'],
+     * 	['id' => 1, 'name' = 'Second tag'],
+     * ]
+     *
+     * @return array
+     * @since 6.0.0
+     */
+    public function getTags();
+
+    /**
+     * Get a list of tags for the given item ids.
+     *
+     * This returns an array with object id / tag names:
+     * [
+     *   1 => array('First tag', 'Second tag'),
+     *   2 => array('Second tag'),
+     *   3 => array('Second tag', 'Third tag'),
+     * ]
+     *
+     * @param array $objIds item ids
+     * @return array|boolean with object id as key and an array
+     * of tag names as value or false if an error occurred
+     * @since 8.0.0
+     */
+    public function getTagsForObjects(array $objIds);
+
+    /**
+     * Get a list of items tagged with $tag.
+     *
+     * Throws an exception if the tag could not be found.
+     *
+     * @param string|integer $tag Tag id or name.
+     * @return array|false An array of object ids or false on error.
+     * @since 6.0.0
+     */
+    public function getIdsForTag($tag);
+
+    /**
+     * Checks whether a tag is already saved.
+     *
+     * @param string $name The name to check for.
+     * @return bool
+     * @since 6.0.0
+     */
+    public function hasTag($name);
+
+    /**
+     * Checks whether a tag is saved for the given user,
+     * disregarding the ones shared with him or her.
+     *
+     * @param string $name The tag name to check for.
+     * @param string $user The user whose tags are to be checked.
+     * @return bool
+     * @since 8.0.0
+     */
+    public function userHasTag($name, $user);
+
+    /**
+     * Add a new tag.
+     *
+     * @param string $name A string with a name of the tag
+     * @return int|false the id of the added tag or false if it already exists.
+     * @since 6.0.0
+     */
+    public function add($name);
+
+    /**
+     * Rename tag.
+     *
+     * @param string|integer $from The name or ID of the existing tag
+     * @param string $to The new name of the tag.
+     * @return bool
+     * @since 6.0.0
+     */
+    public function rename($from, $to);
+
+    /**
+     * Add a list of new tags.
+     *
+     * @param string[] $names A string with a name or an array of strings containing
+     * the name(s) of the to add.
+     * @param bool $sync When true, save the tags
+     * @param int|null $id int Optional object id to add to this|these tag(s)
+     * @return bool Returns false on error.
+     * @since 6.0.0
+     */
+    public function addMultiple($names, $sync=false, $id = null);
+
+    /**
+     * Delete tag/object relations from the db
+     *
+     * @param array $ids The ids of the objects
+     * @return boolean Returns false on error.
+     * @since 6.0.0
+     */
+    public function purgeObjects(array $ids);
+
+    /**
+     * Get favorites for an object type
+     *
+     * @return array|false An array of object ids.
+     * @since 6.0.0
+     */
+    public function getFavorites();
+
+    /**
+     * Add an object to favorites
+     *
+     * @param int $objid The id of the object
+     * @return boolean
+     * @since 6.0.0
+     */
+    public function addToFavorites($objid);
+
+    /**
+     * Remove an object from favorites
+     *
+     * @param int $objid The id of the object
+     * @return boolean
+     * @since 6.0.0
+     */
+    public function removeFromFavorites($objid);
+
+    /**
+     * Creates a tag/object relation.
+     *
+     * @param int $objid The id of the object
+     * @param string $tag The id or name of the tag
+     * @return boolean Returns false on database error.
+     * @since 6.0.0
+     */
+    public function tagAs($objid, $tag);
+
+    /**
+     * Delete single tag/object relation from the db
+     *
+     * @param int $objid The id of the object
+     * @param string $tag The id or name of the tag
+     * @return boolean
+     * @since 6.0.0
+     */
+    public function unTag($objid, $tag);
+
+    /**
+     * Delete tags from the database
+     *
+     * @param string[]|integer[] $names An array of tags (names or IDs) to delete
+     * @return bool Returns false on error
+     * @since 6.0.0
+     */
+    public function delete($names);
 
 }

Spacing +1 added lines, -1 removed lines

@@ -159,7 +159,7 @@
 	 * @return bool Returns false on error.
 	 * @since 6.0.0
 	 */
-	public function addMultiple($names, $sync=false, $id = null);
+	public function addMultiple($names, $sync = false, $id = null);
 
 	/**
 	 * Delete tag/object relations from the db

lib/public/Diagnostics/IEvent.php

Indentation +25 added lines, -25 removed lines

@@ -30,33 +30,33 @@
  * @since 8.0.0
  */
 interface IEvent {
-	/**
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getId();
+    /**
+     * @return string
+     * @since 8.0.0
+     */
+    public function getId();
 
-	/**
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getDescription();
+    /**
+     * @return string
+     * @since 8.0.0
+     */
+    public function getDescription();
 
-	/**
-	 * @return float
-	 * @since 8.0.0
-	 */
-	public function getStart();
+    /**
+     * @return float
+     * @since 8.0.0
+     */
+    public function getStart();
 
-	/**
-	 * @return float
-	 * @since 8.0.0
-	 */
-	public function getEnd();
+    /**
+     * @return float
+     * @since 8.0.0
+     */
+    public function getEnd();
 
-	/**
-	 * @return float
-	 * @since 8.0.0
-	 */
-	public function getDuration();
+    /**
+     * @return float
+     * @since 8.0.0
+     */
+    public function getDuration();
 }

lib/public/ITempManager.php

Indentation +33 added lines, -33 removed lines

@@ -31,41 +31,41 @@
  * @since 8.0.0
  */
 interface ITempManager {
-	/**
-	 * Create a temporary file and return the path
-	 *
-	 * @param string $postFix
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getTemporaryFile($postFix = '');
+    /**
+     * Create a temporary file and return the path
+     *
+     * @param string $postFix
+     * @return string
+     * @since 8.0.0
+     */
+    public function getTemporaryFile($postFix = '');
 
-	/**
-	 * Create a temporary folder and return the path
-	 *
-	 * @param string $postFix
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getTemporaryFolder($postFix = '');
+    /**
+     * Create a temporary folder and return the path
+     *
+     * @param string $postFix
+     * @return string
+     * @since 8.0.0
+     */
+    public function getTemporaryFolder($postFix = '');
 
-	/**
-	 * Remove the temporary files and folders generated during this request
-	 * @since 8.0.0
-	 */
-	public function clean();
+    /**
+     * Remove the temporary files and folders generated during this request
+     * @since 8.0.0
+     */
+    public function clean();
 
-	/**
-	 * Remove old temporary files and folders that were failed to be cleaned
-	 * @since 8.0.0
-	 */
-	public function cleanOld();
+    /**
+     * Remove old temporary files and folders that were failed to be cleaned
+     * @since 8.0.0
+     */
+    public function cleanOld();
 
-	/**
-	 * Get the temporary base directory
-	 *
-	 * @return string
-	 * @since 8.2.0
-	 */
-	public function getTempBaseDir();
+    /**
+     * Get the temporary base directory
+     *
+     * @return string
+     * @since 8.2.0
+     */
+    public function getTempBaseDir();
 }

lib/public/WorkflowEngine/IManager.php

Indentation +13 added lines, -13 removed lines

@@ -31,18 +31,18 @@
  * @since 9.1
  */
 interface IManager {
-	/**
-	 * @param IStorage $storage
-	 * @param string $path
-	 * @since 9.1
-	 */
-	public function setFileInfo(IStorage $storage, $path);
+    /**
+     * @param IStorage $storage
+     * @param string $path
+     * @since 9.1
+     */
+    public function setFileInfo(IStorage $storage, $path);
 
-	/**
-	 * @param string $class
-	 * @param bool $returnFirstMatchingOperationOnly
-	 * @return array
-	 * @since 9.1
-	 */
-	public function getMatchingOperations($class, $returnFirstMatchingOperationOnly = true);
+    /**
+     * @param string $class
+     * @param bool $returnFirstMatchingOperationOnly
+     * @return array
+     * @since 9.1
+     */
+    public function getMatchingOperations($class, $returnFirstMatchingOperationOnly = true);
 }

lib/public/WorkflowEngine/IOperation.php

Indentation +8 added lines, -8 removed lines

@@ -28,12 +28,12 @@
  * @since 9.1
  */
 interface IOperation {
-	/**
-	 * @param string $name
-	 * @param array[] $checks
-	 * @param string $operation
-	 * @throws \UnexpectedValueException
-	 * @since 9.1
-	 */
-	public function validateOperation($name, array $checks, $operation);
+    /**
+     * @param string $name
+     * @param array[] $checks
+     * @param string $operation
+     * @throws \UnexpectedValueException
+     * @since 9.1
+     */
+    public function validateOperation($name, array $checks, $operation);
 }

lib/public/WorkflowEngine/ICheck.php

Indentation +20 added lines, -20 removed lines

@@ -31,26 +31,26 @@
  * @since 9.1
  */
 interface ICheck {
-	/**
-	 * @param IStorage $storage
-	 * @param string $path
-	 * @since 9.1
-	 */
-	public function setFileInfo(IStorage $storage, $path);
+    /**
+     * @param IStorage $storage
+     * @param string $path
+     * @since 9.1
+     */
+    public function setFileInfo(IStorage $storage, $path);
 
-	/**
-	 * @param string $operator
-	 * @param string $value
-	 * @return bool
-	 * @since 9.1
-	 */
-	public function executeCheck($operator, $value);
+    /**
+     * @param string $operator
+     * @param string $value
+     * @return bool
+     * @since 9.1
+     */
+    public function executeCheck($operator, $value);
 
-	/**
-	 * @param string $operator
-	 * @param string $value
-	 * @throws \UnexpectedValueException
-	 * @since 9.1
-	 */
-	public function validateCheck($operator, $value);
+    /**
+     * @param string $operator
+     * @param string $value
+     * @throws \UnexpectedValueException
+     * @since 9.1
+     */
+    public function validateCheck($operator, $value);
 }

lib/public/Route/IRouter.php

Indentation +79 added lines, -79 removed lines

@@ -36,92 +36,92 @@
  */
 interface IRouter {
 
-	/**
-	 * Get the files to load the routes from
-	 *
-	 * @return string[]
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function getRoutingFiles();
+    /**
+     * Get the files to load the routes from
+     *
+     * @return string[]
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function getRoutingFiles();
 
-	/**
-	 * @return string
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function getCacheKey();
+    /**
+     * @return string
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function getCacheKey();
 
-	/**
-	 * Loads the routes
-	 *
-	 * @param null|string $app
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function loadRoutes($app = null);
+    /**
+     * Loads the routes
+     *
+     * @param null|string $app
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function loadRoutes($app = null);
 
-	/**
-	 * Sets the collection to use for adding routes
-	 *
-	 * @param string $name Name of the collection to use.
-	 * @return void
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function useCollection($name);
+    /**
+     * Sets the collection to use for adding routes
+     *
+     * @param string $name Name of the collection to use.
+     * @return void
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function useCollection($name);
 
-	/**
-	 * returns the current collection name in use for adding routes
-	 *
-	 * @return string the collection name
-	 * @since 8.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function getCurrentCollection();
+    /**
+     * returns the current collection name in use for adding routes
+     *
+     * @return string the collection name
+     * @since 8.0.0
+     * @deprecated 9.0.0
+     */
+    public function getCurrentCollection();
 
-	/**
-	 * Create a \OCP\Route\IRoute.
-	 *
-	 * @param string $name Name of the route to create.
-	 * @param string $pattern The pattern to match
-	 * @param array $defaults An array of default parameter values
-	 * @param array $requirements An array of requirements for parameters (regexes)
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function create($name, $pattern, array $defaults = array(), array $requirements = array());
+    /**
+     * Create a \OCP\Route\IRoute.
+     *
+     * @param string $name Name of the route to create.
+     * @param string $pattern The pattern to match
+     * @param array $defaults An array of default parameter values
+     * @param array $requirements An array of requirements for parameters (regexes)
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function create($name, $pattern, array $defaults = array(), array $requirements = array());
 
-	/**
-	 * Find the route matching $url.
-	 *
-	 * @param string $url The url to find
-	 * @throws \Exception
-	 * @return void
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function match($url);
+    /**
+     * Find the route matching $url.
+     *
+     * @param string $url The url to find
+     * @throws \Exception
+     * @return void
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function match($url);
 
-	/**
-	 * Get the url generator
-	 *
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function getGenerator();
+    /**
+     * Get the url generator
+     *
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function getGenerator();
 
-	/**
-	 * Generate url based on $name and $parameters
-	 *
-	 * @param string $name Name of the route to use.
-	 * @param array $parameters Parameters for the route
-	 * @param bool $absolute
-	 * @return string
-	 * @since 7.0.0
-	 * @deprecated 9.0.0
-	 */
-	public function generate($name, $parameters = array(), $absolute = false);
+    /**
+     * Generate url based on $name and $parameters
+     *
+     * @param string $name Name of the route to use.
+     * @param array $parameters Parameters for the route
+     * @param bool $absolute
+     * @return string
+     * @since 7.0.0
+     * @deprecated 9.0.0
+     */
+    public function generate($name, $parameters = array(), $absolute = false);
 
 }

lib/public/Route/IRoute.php

Indentation +75 added lines, -75 removed lines

@@ -31,88 +31,88 @@
  * @since 7.0.0
  */
 interface IRoute {
-	/**
-	 * Specify PATCH as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function patch();
+    /**
+     * Specify PATCH as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function patch();
 
-	/**
-	 * Specify the method when this route is to be used
-	 *
-	 * @param string $method HTTP method (uppercase)
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function method($method);
+    /**
+     * Specify the method when this route is to be used
+     *
+     * @param string $method HTTP method (uppercase)
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function method($method);
 
-	/**
-	 * The action to execute when this route matches, includes a file like
-	 * it is called directly
-	 *
-	 * @param string $file
-	 * @return void
-	 * @since 7.0.0
-	 */
-	public function actionInclude($file);
+    /**
+     * The action to execute when this route matches, includes a file like
+     * it is called directly
+     *
+     * @param string $file
+     * @return void
+     * @since 7.0.0
+     */
+    public function actionInclude($file);
 
-	/**
-	 * Specify GET as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function get();
+    /**
+     * Specify GET as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function get();
 
-	/**
-	 * Specify POST as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function post();
+    /**
+     * Specify POST as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function post();
 
-	/**
-	 * Specify DELETE as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function delete();
+    /**
+     * Specify DELETE as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function delete();
 
-	/**
-	 * The action to execute when this route matches
-	 *
-	 * @param string|callable $class the class or a callable
-	 * @param string $function the function to use with the class
-	 * @return \OCP\Route\IRoute
-	 *
-	 * This function is called with $class set to a callable or
-	 * to the class with $function
-	 * @since 7.0.0
-	 */
-	public function action($class, $function = null);
+    /**
+     * The action to execute when this route matches
+     *
+     * @param string|callable $class the class or a callable
+     * @param string $function the function to use with the class
+     * @return \OCP\Route\IRoute
+     *
+     * This function is called with $class set to a callable or
+     * to the class with $function
+     * @since 7.0.0
+     */
+    public function action($class, $function = null);
 
-	/**
-	 * Defaults to use for this route
-	 *
-	 * @param array $defaults The defaults
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function defaults($defaults);
+    /**
+     * Defaults to use for this route
+     *
+     * @param array $defaults The defaults
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function defaults($defaults);
 
-	/**
-	 * Requirements for this route
-	 *
-	 * @param array $requirements The requirements
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function requirements($requirements);
+    /**
+     * Requirements for this route
+     *
+     * @param array $requirements The requirements
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function requirements($requirements);
 
-	/**
-	 * Specify PUT as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function put();
+    /**
+     * Specify PUT as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function put();
 }