WP_Term::get_instance( int $term_id, string $taxonomy = null ): WP_Term|WP_Error|false

116	public static function get_instance( $term_id, $taxonomy = null ) {117		global $wpdb;118 119		$term_id = (int) $term_id;120		if ( ! $term_id ) {121			return false;122		}123 124		$_term = wp_cache_get( $term_id, 'terms' );125 126		// If there isn't a cached version, hit the database.127		if ( ! $_term || ( $taxonomy && $taxonomy !== $_term->taxonomy ) ) {128			// Any term found in the cache is not a match, so don't use it.129			$_term = false;130 131			// Grab all matching terms, in case any are shared between taxonomies.132			$terms = $wpdb->get_results( $wpdb->prepare( "SELECT t.*, tt.* FROM $wpdb->terms AS t INNER JOIN $wpdb->term_taxonomy AS tt ON t.term_id = tt.term_id WHERE t.term_id = %d", $term_id ) );133			if ( ! $terms ) {134				return false;135			}136 137			// If a taxonomy was specified, find a match.138			if ( $taxonomy ) {139				foreach ( $terms as $match ) {140					if ( $taxonomy === $match->taxonomy ) {141						$_term = $match;142						break;143					}144				}145 146				// If only one match was found, it's the one we want.147			} elseif ( 1 === count( $terms ) ) {148				$_term = reset( $terms );149 150				// Otherwise, the term must be shared between taxonomies.151			} else {152				// If the term is shared only with invalid taxonomies, return the one valid term.153				foreach ( $terms as $t ) {154					if ( ! taxonomy_exists( $t->taxonomy ) ) {155						continue;156					}157 158					// Only hit if we've already identified a term in a valid taxonomy.159					if ( $_term ) {160						return new WP_Error( 'ambiguous_term_id', __( 'Term ID is shared between multiple taxonomies' ), $term_id );161					}162 163					$_term = $t;164				}165			}166 167			if ( ! $_term ) {168				return false;169			}170 171			// Don't return terms from invalid taxonomies.172			if ( ! taxonomy_exists( $_term->taxonomy ) ) {173				return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );174			}175 176			$_term = sanitize_term( $_term, $_term->taxonomy, 'raw' );177 178			// Don't cache terms that are shared between taxonomies.179			if ( 1 === count( $terms ) ) {180				wp_cache_add( $term_id, $_term, 'terms' );181			}182		}183 184		$term_obj = new WP_Term( $_term );185		$term_obj->filter( $term_obj->filter );186 187		return $term_obj;188	}
When	Instructions	Calls it makes
always	7	none
always	23–26	`wp_cache_get(), ->filter()`
always	30–44	`wp_cache_get(), ->prepare(), ->get_results()`
always	40–44	`wp_cache_get(), ->prepare(), ->get_results(), reset()`
always	48–57	`wp_cache_get(), ->prepare(), ->get_results(), taxonomy_exists(), __()`
`!taxonomy_exists()`	53–57	`wp_cache_get(), ->prepare(), ->get_results(), reset(), taxonomy_exists(), __()`
`taxonomy_exists()`	61–70	`wp_cache_get(), ->prepare(), ->get_results(), taxonomy_exists(), sanitize_term(), ->filter()`
`taxonomy_exists()`	66–75	`wp_cache_get(), ->prepare(), ->get_results(), taxonomy_exists(), sanitize_term(), wp_cache_add(), ->filter()`
`taxonomy_exists()`	66–70	`wp_cache_get(), ->prepare(), ->get_results(), reset(), taxonomy_exists(), sanitize_term(), ->filter()`
`taxonomy_exists()`	71–75	`wp_cache_get(), ->prepare(), ->get_results(), reset(), taxonomy_exists(), sanitize_term(), wp_cache_add(), ->filter()`