function field_read_field

cis7 field_read_field($field_name, $include_additional = array())
cle7 field_read_field($field_name, $include_additional = array())
elmsmedia7 field_read_field($field_name, $include_additional = array())
icor7 field_read_field($field_name, $include_additional = array())
meedjum_blog7 field_read_field($field_name, $include_additional = array())
mooc7 field_read_field($field_name, $include_additional = array())

Reads a single field record directly from the database.

Generally, you should use the field_info_field() instead.

This function will not return deleted fields. Use field_read_fields() instead for this purpose.


$field_name: The field name to read.

array $include_additional: The default behavior of this function is to not return a field that is inactive. Setting $include_additional['include_inactive'] to TRUE will override this behavior.

Return value

A field definition array, or FALSE.

Related topics

11 calls to field_read_field()
ctools_fields_fake_field_instance in sites/all/modules/ulmus/ctools/includes/
Fake an instance of a field.
defaultconfig_component_rebuild_fields in sites/all/modules/ulmus/defaultconfig/defaultconfig.module
FieldInfo::getField in modules/field/
Returns a field definition from a field name.
field_create_field in modules/field/
Creates a field.
field_create_instance in modules/field/
Creates an instance of a field, binding it to a bundle.

... See full list

1 string reference to 'field_read_field'
field_read_fields in modules/field/
Reads in fields that match an array of conditions.


modules/field/, line 315
Field CRUD API, handling field and field instance creation and deletion.


function field_read_field($field_name, $include_additional = array()) {
  $fields = field_read_fields(array('field_name' => $field_name), $include_additional);
  return $fields ? current($fields) : FALSE;