getid3_lib::CopyTagsToComments( array $ThisFileInfo, bool $option_tags_html = true ): bool

1570	public static function CopyTagsToComments(&$ThisFileInfo, $option_tags_html=true) {1571		// Copy all entries from ['tags'] into common ['comments']1572		if (!empty($ThisFileInfo['tags'])) {1573 1574			// Some tag types can only support limited character sets and may contain data in non-standard encoding (usually ID3v1)1575			// and/or poorly-transliterated tag values that are also in tag formats that do support full-range character sets1576			// To make the output more user-friendly, process the potentially-problematic tag formats last to enhance the chance that1577			// the first entries in [comments] are the most correct and the "bad" ones (if any) come later.1578			// https://github.com/JamesHeinrich/getID3/issues/3381579			$processLastTagTypes = array('id3v1','riff');1580			foreach ($processLastTagTypes as $processLastTagType) {1581				if (isset($ThisFileInfo['tags'][$processLastTagType])) {1582					// bubble ID3v1 to the end, if present to aid in detecting bad ID3v1 encodings1583					$temp = $ThisFileInfo['tags'][$processLastTagType];1584					unset($ThisFileInfo['tags'][$processLastTagType]);1585					$ThisFileInfo['tags'][$processLastTagType] = $temp;1586					unset($temp);1587				}1588			}1589			foreach ($ThisFileInfo['tags'] as $tagtype => $tagarray) {1590				foreach ($tagarray as $tagname => $tagdata) {1591					foreach ($tagdata as $key => $value) {1592						if (!empty($value)) {1593							if (empty($ThisFileInfo['comments'][$tagname])) {1594 1595								// fall through and append value1596 1597							} elseif ($tagtype == 'id3v1') {1598 1599								$newvaluelength = strlen(trim($value));1600								foreach ($ThisFileInfo['comments'][$tagname] as $existingkey => $existingvalue) {1601									$oldvaluelength = strlen(trim($existingvalue));1602									if (($newvaluelength <= $oldvaluelength) && (substr($existingvalue, 0, $newvaluelength) == trim($value))) {1603										// new value is identical but shorter-than (or equal-length to) one already in comments - skip1604										break 2;1605									}1606 1607									if (function_exists('mb_convert_encoding')) {1608										if (trim($value) == trim(substr(mb_convert_encoding($existingvalue, $ThisFileInfo['id3v1']['encoding'], $ThisFileInfo['encoding']), 0, 30))) {1609											// value stored in ID3v1 appears to be probably the multibyte value transliterated (badly) into ISO-8859-1 in ID3v1.1610											// As an example, Foobar2000 will do this if you tag a file with Chinese or Arabic or Cyrillic or something that doesn't fit into ISO-8859-1 the ID3v1 will consist of mostly "?" characters, one per multibyte unrepresentable character1611											break 2;1612										}1613									}1614								}1615 1616							} elseif (!is_array($value)) {1617 1618								$newvaluelength   =    strlen(trim($value));1619								$newvaluelengthMB = mb_strlen(trim($value));1620								foreach ($ThisFileInfo['comments'][$tagname] as $existingkey => $existingvalue) {1621									$oldvaluelength   =    strlen(trim($existingvalue));1622									$oldvaluelengthMB = mb_strlen(trim($existingvalue));1623									if (($newvaluelengthMB == $oldvaluelengthMB) && ($existingvalue == getid3_lib::iconv_fallback('UTF-8', 'ASCII', $value))) {1624										// https://github.com/JamesHeinrich/getID3/issues/3381625										// check for tags containing extended characters that may have been forced into limited-character storage (e.g. UTF8 values into ASCII)1626										// which will usually display unrepresentable characters as "?"1627										$ThisFileInfo['comments'][$tagname][$existingkey] = trim($value);1628										break;1629									}1630									if ((strlen($existingvalue) > 10) && ($newvaluelength > $oldvaluelength) && (substr(trim($value), 0, strlen($existingvalue)) == $existingvalue)) {1631										$ThisFileInfo['comments'][$tagname][$existingkey] = trim($value);1632										break;1633									}1634								}1635 1636							}1637							if (is_array($value) || empty($ThisFileInfo['comments'][$tagname]) || !in_array(trim($value), $ThisFileInfo['comments'][$tagname])) {1638								$value = (is_string($value) ? trim($value) : $value);1639								if (!is_int($key) && !ctype_digit($key)) {1640									$ThisFileInfo['comments'][$tagname][$key] = $value;1641								} else {1642									if (!isset($ThisFileInfo['comments'][$tagname])) {1643										$ThisFileInfo['comments'][$tagname] = array($value);1644									} else {1645										$ThisFileInfo['comments'][$tagname][] = $value;1646									}1647								}1648							}1649						}