get_term_by( string $field, string|int $value, string $taxonomy = '', string $output = OBJECT, string $filter = 'raw' ): WP_Term|array|false

1099function get_term_by( $field, $value, $taxonomy = '', $output = OBJECT, $filter = 'raw' ) {1100 1101	// 'term_taxonomy_id' lookups don't require taxonomy checks.1102	if ( 'term_taxonomy_id' !== $field && ! taxonomy_exists( $taxonomy ) ) {1103		return false;1104	}1105 1106	// No need to perform a query for empty 'slug' or 'name'.1107	if ( 'slug' === $field || 'name' === $field ) {1108		$value = (string) $value;1109 1110		if ( 0 === strlen( $value ) ) {1111			return false;1112		}1113	}1114 1115	if ( 'id' === $field || 'ID' === $field || 'term_id' === $field ) {1116		$term = get_term( (int) $value, $taxonomy, $output, $filter );1117		if ( is_wp_error( $term ) || null === $term ) {1118			$term = false;1119		}1120		return $term;1121	}1122 1123	$args = array(1124		'get'                    => 'all',1125		'number'                 => 1,1126		'taxonomy'               => $taxonomy,1127		'update_term_meta_cache' => false,1128		'orderby'                => 'none',1129		'suppress_filter'        => true,1130	);1131 1132	switch ( $field ) {1133		case 'slug':1134			$args['slug'] = $value;1135			break;1136		case 'name':1137			$args['name'] = $value;1138			break;1139		case 'term_taxonomy_id':1140			$args['term_taxonomy_id'] = $value;1141			unset( $args['taxonomy'] );1142			break;1143		default:1144			return false;1145	}1146 1147	$terms = get_terms( $args );1148	if ( is_wp_error( $terms ) || empty( $terms ) ) {1149		return false;1150	}1151 1152	$term = array_shift( $terms );1153 1154	// In the case of 'term_taxonomy_id', override the provided `$taxonomy` with whatever we find in the DB.1155	if ( 'term_taxonomy_id' === $field ) {1156		$taxonomy = $term->taxonomy;1157	}1158 1159	return get_term( $term, $taxonomy, $output, $filter );1160}