function field_info_instance

7.x field.info.inc field_info_instance($entity_type, $field_name, $bundle_name)

Returns an array of instance data for a specific field and bundle.

The function populates a static cache with all fields and instances used in the bundle, allowing fast retrieval of field_info_field() or field_info_instance() later in the request.

Parameters

$entity_type: The entity type for the instance.

$field_name: The field name for the instance.

$bundle_name: The bundle name for the instance.

Return value

An associative array of instance data for the specific field and bundle; NULL if the instance does not exist.

Related topics

Field Info API
Obtain information about Field API configuration.
41 calls to field_info_instance()
CommentTokenReplaceTestCase::testCommentTokenReplacement in drupal-7.x/modules/comment/comment.test
Creates a comment, then tests the tokens generated from it.
comment_tokens in drupal-7.x/modules/comment/comment.tokens.inc
Implements hook_tokens().
FieldAttachStorageTestCase::testFieldAttachCreateRenameBundle in drupal-7.x/modules/field/tests/field.test
Test field_attach_create_bundle() and field_attach_rename_bundle().
FieldAttachStorageTestCase::testFieldStorageDetailsAlter in drupal-7.x/modules/field/tests/field.test
Test storage details alteration.
FieldBulkDeleteTestCase::testDeleteFieldInstance in drupal-7.x/modules/field/tests/field.test
Verify that deleting an instance leaves the field data items in the database and that the appropriate Field API functions can operate on the deleted data and instance.

... See full list

File

drupal-7.x/modules/field/field.info.inc, line 623
Field Info API, providing information about available fields and field types.

Code

function field_info_instance($entity_type, $field_name, $bundle_name) {
  $cache = _field_info_field_cache();
  $info = $cache->getBundleInstances($entity_type, $bundle_name);
  if (isset($info[$field_name])) {
    return $info[$field_name];
  }
}