Page Menu
Home
Phabricator
Search
Configure Global Search
Log In
Files
F13978408
D15347.id37015.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Award Token
Flag For Later
Size
1 KB
Referenced Files
None
Subscribers
None
D15347.id37015.diff
View Options
diff --git a/src/__phutil_library_map__.php b/src/__phutil_library_map__.php
--- a/src/__phutil_library_map__.php
+++ b/src/__phutil_library_map__.php
@@ -411,6 +411,7 @@
'hsprintf' => 'markup/render.php',
'id' => 'utils/utils.php',
'idx' => 'utils/utils.php',
+ 'idxv' => 'utils/utils.php',
'ifilter' => 'utils/utils.php',
'igroup' => 'utils/utils.php',
'ipull' => 'utils/utils.php',
diff --git a/src/utils/utils.php b/src/utils/utils.php
--- a/src/utils/utils.php
+++ b/src/utils/utils.php
@@ -49,6 +49,39 @@
/**
+ * Access a sequence of array indexes, retrieving a deeply nested value if
+ * it exists or a default if it does not.
+ *
+ * For example, `idxv($dict, array('a', 'b', 'c'))` accesses the key at
+ * `$dict['a']['b']['c']`, if it exists. If it does not, or any intermediate
+ * value is not itself an array, it returns the defualt value.
+ *
+ * @param array Array to access.
+ * @param list<string> List of keys to access, in sequence.
+ * @param wild Default value to return.
+ * @return wild Accessed value, or default if the value is not accessible.
+ */
+function idxv(array $map, array $path, $default = null) {
+ if (!$path) {
+ return $default;
+ }
+
+ $last = last($path);
+ $path = array_slice($path, 0, -1);
+
+ $cursor = $map;
+ foreach ($path as $key) {
+ $cursor = idx($cursor, $key);
+ if (!is_array($cursor)) {
+ return $default;
+ }
+ }
+
+ return idx($cursor, $last, $default);
+}
+
+
+/**
* Call a method on a list of objects. Short for "method pull", this function
* works just like @{function:ipull}, except that it operates on a list of
* objects instead of a list of arrays. This function simplifies a common type
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Sat, Oct 19, 11:03 PM (2 w, 5 d ago)
Storage Engine
blob
Storage Format
Encrypted (AES-256-CBC)
Storage Handle
6734221
Default Alt Text
D15347.id37015.diff (1 KB)
Attached To
Mode
D15347: Introduce idxv(), like idx()
Attached
Detach File
Event Timeline
Log In to Comment