Version 1

[yaffs-website] / vendor / symfony / validator / Mapping / TraversalStrategy.php

diff --git a/vendor/symfony/validator/Mapping/TraversalStrategy.php b/vendor/symfony/validator/Mapping/TraversalStrategy.php
new file mode 100644 (file)
index 0000000..164992b
--- /dev/null
+++ b/vendor/symfony/validator/Mapping/TraversalStrategy.php
@@ -0,0 +1,65 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+/**
+ * Specifies whether and how a traversable object should be traversed.
+ *
+ * If the node traverser traverses a node whose value is an instance of
+ * {@link \Traversable}, and if that node is either a class node or if
+ * cascading is enabled, then the node's traversal strategy will be checked.
+ * Depending on the requested traversal strategy, the node traverser will
+ * iterate over the object and cascade each object or collection returned by
+ * the iterator.
+ *
+ * The traversal strategy is ignored for arrays. Arrays are always iterated.
+ *
+ * @author Bernhard Schussek <bschussek@gmail.com>
+ *
+ * @see CascadingStrategy
+ */
+class TraversalStrategy
+{
+    /**
+     * Specifies that a node's value should be iterated only if it is an
+     * instance of {@link \Traversable}.
+     */
+    const IMPLICIT = 1;
+
+    /**
+     * Specifies that a node's value should never be iterated.
+     */
+    const NONE = 2;
+
+    /**
+     * Specifies that a node's value should always be iterated. If the value is
+     * not an instance of {@link \Traversable}, an exception should be thrown.
+     */
+    const TRAVERSE = 4;
+
+    /**
+     * Specifies that nested instances of {@link \Traversable} should never be
+     * iterated. Can be combined with {@link IMPLICIT} or {@link TRAVERSE}.
+     *
+     * @deprecated since version 2.5, to be removed in 3.0. This constant was added for backwards compatibility only.
+     *
+     * @internal
+     */
+    const STOP_RECURSION = 8;
+
+    /**
+     * Not instantiable.
+     */
+    private function __construct()
+    {
+    }
+}