api/symfony/Component/PropertyAccess/PropertyAccessorInterface.yaml
2024-09-26 02:03:21 -07:00

168 lines
4 KiB
YAML

name: PropertyAccessorInterface
class_comment: null
dependencies:
- name: PropertyAccess
type: class
source: Symfony\Component\PropertyAccess\PropertyAccess
- name: PropertyAccess
type: class
source: Symfony\Component\PropertyAccess\PropertyAccess
properties: []
methods:
- name: setValue
visibility: public
parameters:
- name: '&$objectOrArray'
- name: propertyPath
- name: value
comment: '# * Writes and reads values to/from an object/array graph.
# *
# * @author Bernhard Schussek <bschussek@gmail.com>
# */
# interface PropertyAccessorInterface
# {
# /**
# * Sets the value at the end of the property path of the object graph.
# *
# * Example:
# *
# * use Symfony\Component\PropertyAccess\PropertyAccess;
# *
# * $propertyAccessor = PropertyAccess::createPropertyAccessor();
# *
# * echo $propertyAccessor->setValue($object, ''child.name'', ''Fabien'');
# * // equals echo $object->getChild()->setName(''Fabien'');
# *
# * This method first tries to find a public setter for each property in the
# * path. The name of the setter must be the camel-cased property name
# * prefixed with "set".
# *
# * If the setter does not exist, this method tries to find a public
# * property. The value of the property is then changed.
# *
# * If neither is found, an exception is thrown.
# *
# * @throws Exception\InvalidArgumentException If the property path is invalid
# * @throws Exception\AccessException If a property/index does not exist
or is not public
# * @throws Exception\UnexpectedTypeException If a value within the path is neither
object nor array'
- name: getValue
visibility: public
parameters:
- name: objectOrArray
- name: propertyPath
comment: '# * Returns the value at the end of the property path of the object graph.
# *
# * Example:
# *
# * use Symfony\Component\PropertyAccess\PropertyAccess;
# *
# * $propertyAccessor = PropertyAccess::createPropertyAccessor();
# *
# * echo $propertyAccessor->getValue($object, ''child.name'');
# * // equals echo $object->getChild()->getName();
# *
# * This method first tries to find a public getter for each property in the
# * path. The name of the getter must be the camel-cased property name
# * prefixed with "get", "is", or "has".
# *
# * If the getter does not exist, this method tries to find a public
# * property. The value of the property is then returned.
# *
# * If none of them are found, an exception is thrown.
# *
# * @throws Exception\InvalidArgumentException If the property path is invalid
# * @throws Exception\AccessException If a property/index does not exist
or is not public
# * @throws Exception\UnexpectedTypeException If a value within the path is neither
object
# * nor array'
- name: isWritable
visibility: public
parameters:
- name: objectOrArray
- name: propertyPath
comment: '# * Returns whether a value can be written at a given property path.
# *
# * Whenever this method returns true, {@link setValue()} is guaranteed not
# * to throw an exception when called with the same arguments.
# *
# * @throws Exception\InvalidArgumentException If the property path is invalid'
- name: isReadable
visibility: public
parameters:
- name: objectOrArray
- name: propertyPath
comment: '# * Returns whether a property path can be read from an object graph.
# *
# * Whenever this method returns true, {@link getValue()} is guaranteed not
# * to throw an exception when called with the same arguments.
# *
# * @throws Exception\InvalidArgumentException If the property path is invalid'
traits:
- Symfony\Component\PropertyAccess\PropertyAccess
- Symfony\Component\PropertyAccess\PropertyAccess
interfaces: []