WordPress网站
获取WordPress
WordPress网站

WordPress开发人员资源

wp_list_pluck（）

wp_列表_运气(阵列 $input_list（输入列表）,int |字符串 $字段,int |字符串 $索引键 = 无效的 ):阵列

在本文中

返回页首

从数组中的每个对象或数组中删除特定字段。

说明

它具有与array_column（）（PHP 5.5）相同的功能和原型，但也支持对象。

参数

$input_list（输入列表）阵列必修的
对象或数组的列表。
$字段整数|一串必修的
要放置的对象中的字段，而不是整个对象。
$索引键整数|一串可选择的
对象中用作新数组键的字段。

违约：无效的

返回

阵列找到值的数组。如果$索引键设置为，一个已找到值的数组，其键对应于$索引键.如果$索引键为null，原始的数组键$input_list（输入列表）将保留在结果中。

来源

函数wp_list_pluck（$input_list，$field，$index_key=null）{if（！is_array（$input_list））{return数组（）；}$util=新WP_List_util（$input_List）；返回$util->pull（$field，$index_key）；}

查看所有引用 在Trac上查看 在GitHub上查看

使用说明
WP_List_Util:：__construct（）wp-includes/class-wp-list-util.php

建造师。

使用人说明
WP_Textdomain_Registry:：invalidate_mo_files_cache（）wp-includes/class-wp-textdomain-registry.php

使.mo文件的缓存无效。

update_post_parent_caches（）wp-includes/post.php

更新帖子对象列表的父帖子缓存。

update_post_author_caches（）wp-includes/post.php

更新发布对象列表的发布作者用户缓存。

WP_REST_Menu_Items_Controller:：prepare_item_for_response（）wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php

为响应准备一个post输出。

获取块模板（）wp-includes/block-template-utils.php

基于查询检索统一模板对象的列表。

WP_REST_Term_Search_Handler:：Search_items（）wp-includes/rest-api/search/class-wp-rest-term-search-handler.php

搜索给定搜索请求的字词。

获取媒体状态（）wp-admin/includes/template.php

从附件中检索媒体状态数组。

获取feed_build_date（）wp-includes/feed-php

从获取最近修改的帖子的UTC时间WP_查询.

wp_filter_oembed_iframe_title_attribute（）wp-includes/embedd.php

过滤给定的oEmbed HTML以确保iframe具有title属性。

WP_REST_Post_Search_Handler:：Search_items（）wp-includes/rest-api/search/class-wp-rest-post-search-handler.php

搜索给定搜索请求的帖子。

WP_Widget_Media库：：render_Media（）wp-includes/widgets/class-wp-widget-media-gallery.php

在前端渲染媒体。

WP_Widget_Media音频：：render_Media（）wp-includes/widgets/class-wp-widget-media-audio.php

在前端渲染媒体。

WP_Widget_Media视频：：render_Media（）wp-includes/widgets/class-wp-widget-media-video.php

在前端渲染媒体。

WP_Widget_Media：：form（）wp-includes/widgets/class-wp-widget-media.php

输出设置更新表单。

WP_Widget_Media：：小部件（）wp-includes/widgets/class-wp-widget-media.php

在前端显示小部件。

WP_Widget_Media_Image:：render_Media（）wp-includes/widgets/class-wp-widget-media-image.php

在前端渲染媒体。

WP_Community_Events:：trim_Events（）wp-admin/includes/class-wp-community-events.php

准备事件列表以进行演示。

WP_自定义管理器：：import_theme_starter_content（）wp-includes/class-wp-customize-manager.php

将主题启动器内容导入到自定义状态。

WP_REST_Posts_Controller:：prepare_item_for_response（）wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

为响应准备一个post输出。

WP_REST_Post_Types_Controller:：prepare_item_for_response（）wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php

为序列化准备post类型对象。

WP_Term_Query:：get_terms（）wp包含/class-wp-term-query.php

检索查询结果。

WP_Comment_Query:：fill_descendants（）wp-includes/class-wp-comment-query.php

获取已定位注释的后代。

WP_自定义管理器：：unsanitized_post_values（）wp-includes/class-wp-customize-manager.php

获取当前自定义状态下的脏预设设置值。

WP_自动更新程序：：send_debug_email（）wp-admin/includes/class-wp-automatic-updater.php

准备并发送背景更新结果的完整日志的电子邮件，对调试和极客很有用。

获取terms_to_edit（）wp-admin/includes/taxonomy.php

获取可用于编辑给定帖子ID的以逗号分隔的术语列表。

WP_Plugin_Install_List_Table:：prepare_items（）wp-admin/includes/class-wp-plugin-install-list-table.php
获取在线数据（）wp-admin/includes/template.php

添加隐藏字段和数据，以便在帖子和页面的内联编辑器中使用。

WP_Media_List_Table:：显示行（）wp-admin/includes/class-wp-media-list-table.php
WP_Comments_List_Table:：prepare_items（）wp-admin/includes/class-wp-comments-list-table.php
获取时间（）wp-includes/category-模板.php

检索附加到文章的分类术语。

WP_Query:：get_posts（）wp-includes/class-wp-query.php

基于查询变量检索帖子数组。

_default_wp_die_handler（）wp-includes/functions.php

终止WordPress执行并显示带有错误消息的HTML页面。

WP_Widget_Recent_Comments:：Widget（）wp-includes/widgets/class-wp-widget-recent-comments.php

输出当前“最近的评论”小部件实例的内容。

WP_Tax_Query:：transform_Query（）wp-includes/class-wp-tax-query.php

将单个查询从一个字段转换为另一个字段。

是对象（）wp-includes/分类.php

确定给定对象是否与任何给定术语关联。

wp_insert_term（）wp-includes/分类.php

向数据库中添加新术语。

wp_delete_term（）wp-includes/分类.php

从数据库中删除术语。

获取post_galleries（）wp-includes/media.php

从传递的帖子的内容中检索库。

获取post_galleries_images（）wp-includes/media.php

从图库中检索文章内容中的图像src（如果存在）。

wp_enqueue_media（）wp-includes/media.php

排队使用所有媒体JS API所需的所有脚本、样式、设置和模板。

WP_发布：：__get（）wp-includes/class-wp-post.php

盖特。

wp_update_post（）wp-includes/post.php

使用新帖子数据更新帖子。

再显示37个显示更少

变更日志

版本说明
4.7.0使用工作包列表直到类。
4.0.0添加了$index_key参数。
3.1.0条介绍。

用户贡献的笔记

  1. 跳到注释3内容
    芭芭拉·福特
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：8你必须登录才能对这个便条的帮助进行投票

    这是如何使用此函数的示例。

    以下是列出食品的数组：

    $foods=数组(阵列(“name”=>“香蕉”，“颜色”=>“黄色”，),阵列(“name”=>“Apple”，“颜色”=>“红色”，),阵列(“name”=>“莴苣”，“color”=>“Green”，),阵列(“name”=>“Apple”，“颜色”=>“红色”，),);

    每个食物的名称都可以使用wp_list_pluck（）.

    $food_names=wp_list_pluck（$foods，'name'）；

    $food_names现在将包含一个食品名称的数字索引数组，相当于：

    阵列(“香蕉”，“苹果”，“生菜”，“苹果”);
  2. 跳到注释4内容
    bcworkz公司
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：8你必须登录才能对这个便条的帮助进行投票

    $index_key参数的使用最好保留给唯一字段或索引字段，否则返回的数组中可能会缺少数据。考虑一下上一个例子中修改后的$foods列表：

    $foods=数组(阵列(“name”=>“香蕉”，“颜色”=>“黄色”，),阵列(“name”=>“Apple”，“颜色”=>“红色”，),阵列(“name”=>“Kiwi”，'color'=>空，),阵列(“name”=>“莴苣”，“color”=>“Green”，),阵列(“name”=>“Cherry”，“颜色”=>“红色”，),);

    将“color”用作$index_key有问题。

    $food_names=wp_list_pluck（$foods，'name'，'color'）；

    $food_names包含等效于以下内容的关联数组：

    阵列(“黄色”=>“香蕉”，“红色”=>“樱桃色”，0=>“猕猴桃”，“绿色”=>“生菜”，)

    “Apple”值被随后的“Cherry”覆盖，因为它们都有一个“Red”索引键值。由于“Kiwi”有一个无法使用的颜色值，因此它的键被简单地索引。

你必须登录在能够贡献笔记或反馈之前。