MLKDigitalInkRecognitionModelIdentifier
@interface MLKDigitalInkRecognitionModelIdentifier : NSObject
Stellt ein digitales Tintenerkennungsmodell dar, das für eine Sprache, ein Skript und optional eine regionale Variante spezifisch ist.
-
BCP 47-konformes Sprach-Tag für dieses Modell.
Erklärung
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageTag;
-
Sprach-Subtag, also der aus zwei oder drei Buchstaben bestehende ISO 639-Sprachcode für dieses Erkennungsmodell, z. B.
"en"
für Englisch.Erklärung
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
-
Skript-Subtag, also der aus vier Buchstaben bestehende ISO 15924-Standardcode des in diesem Erkennungsmodell verwendeten Skripts, z. B.
"Latn"
für lateinische Schrift oder"Arab"
für arabische Schrift.Erklärung
Objective-C
@property (nonatomic, readonly, nullable) NSString *scriptSubtag;
-
Das Subtag für die Region, d.h. die aus zwei Buchstaben bestehenden Standardregioncodes nach ISO 3166-1 Alpha 2 oder die durch den Standard UN M.49 definierte Gruppe von numerischen Codes, z.B.
"DE"
für Deutschland oder"002"
für Afrika.Erklärung
Objective-C
@property (nonatomic, readonly, nullable) NSString *regionSubtag;
-
Verwenden Sie stattdessen
from(languageTag:)
.Erklärung
Objective-C
- (nonnull instancetype)init;
-
Gibt eine Modellkennung zurück, die am besten mit der Sprache, dem Skript (falls vorhanden) und der Region (falls vorhanden) übereinstimmt, die im BCP 47-formatierten
languageTag
codiert sind.Der Abgleich erfolgt auf Best-Effort-Basis, d. h., er gibt die Modellkennung zurück, die am besten mit dem angegebenen
languageTag
übereinstimmt. Dabei wird die folgende Heuristik verwendet:- Wenn für das angeforderte Sprach-Subtag keine Modellkennung gefunden wird, Letzteres jedoch Teil einer unterstützten Makrosprache ist, gleichen Sie den Abgleich mit der Makrosprache ab, z.B. stimmt
"arb"
(Standardarabisch) mit"ar"
(Arabisch) überein.- Wenn kein Skript angegeben wird und kein Skript für das angeforderte Sprach-Subtag implizit ist, gleichen Sie den Abgleich mit einem beliebigen Skript ab.
- Wenn das angegebene oder implizite Skript-Subtag eine Teilmenge eines unterstützten Skripts ist, gleichen Sie es auch mit dem zweiten Skript ab. Beispiel:
"zh-Hant"
(Chinesisch, traditionelles Han) wird mit"zh-Hani"
(Chinesisch, Han) abgeglichen.- Wenn kein Regions-Subtag angegeben ist, wird der Abgleich mit einer beliebigen Region durchgeführt.Dabei werden Modellkennungen bevorzugt, die auch keine Region angeben. Beispiel:
"ro"
(Rumänisch) wird mit"ro-RO"
(Rumänisch, Rumänien) übereinstimmen.- Wenn ein Regions-Subtag angegeben ist, aber nicht abgeglichen werden kann, wird der Abgleich mit Regionen durchgeführt, die die angegebene Region enthalten. Beispiel:
"fr-DZ"
(Französisch, Algerien) wird mit"fr-002"
(Französisch, Afrika) abgeglichen.Wenn keine Modellkennung gefunden wird, wird
nil
zurückgegeben.Erklärung
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag error:(NSError *_Nullable *_Nullable)error;
Parameter
languageTag
Ein IETF BCP 47-Sprach-Tag, das die angeforderte Sprache darstellt.
error
Optionales Fehlermeldungsobjekt, das ausgefüllt wird, wenn
languageTag
nicht geparst werden kann.Rückgabewert
Eine Modellkennung, die genau mit dem angegebenen Sprach-Tag übereinstimmt oder die genaueste ungefähre Übereinstimmung oder
nil
, wenn keine entsprechende Modellkennung gefunden wird Legen Sie auchnil
fest, wenn das Sprach-Tag nicht geparst werden konnte. - Wenn für das angeforderte Sprach-Subtag keine Modellkennung gefunden wird, Letzteres jedoch Teil einer unterstützten Makrosprache ist, gleichen Sie den Abgleich mit der Makrosprache ab, z.B. stimmt
-
Gibt eine Modellkennung zurück, die genau mit dem angegebenen
languageTag
übereinstimmt.Der Unterschied zu
from(LanguageTag:)
besteht darin, dass nicht versucht wird,languageTag
zu parsen (und somit keine Fehler generiert). Stattdessen wird nur die Modellkennung zurückgegeben, die genau mitlanguageTag
übereinstimmt, sofern vorhanden.Erklärung
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;
Parameter
languageTag
Das IETF-BCP-47-Sprach-Tag der angeforderten Modellkennung.
Rückgabewert
Ein
DigitalInkRecognitionModelIdentifier
, der genau mit der angegebenenlanguageTag
übereinstimmt odernil
, wenn keiner gefunden wurde. -
Gibt den Satz aller verfügbaren Modellkennungen zurück
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) allModelIdentifiers;
-
Gibt den Satz von Modellkennungen zurück, die das angegebene Sprach-Subtag unterstützen.
Für
"en"
wird beispielsweise eine Reihe von Modellkennungen zurückgegeben, dieenUs
(Englisch, USA),enUk
(Englisch, Vereinigtes Königreich),enKe
(Englisch, Kenia) usw. enthalten.Wenn keine Modellkennungen gefunden werden, die das Sprach-Subtag unterstützen, wird ein leerer Satz zurückgegeben.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;
Parameter
languageSubtag
Ein aus zwei oder drei Buchstaben bestehender ISO 639-Sprachcode, z. B.
"en"
für EnglischRückgabewert
Eine Reihe von Modellkennungen, die den angegebenen
languageSubtag
unterstützen, kann leer sein. -
Gibt die Modellkennungen zurück, die das angegebene Skript-Subtag unterstützen
Für
"Latn"
wird beispielsweise eine Reihe von Modellkennungen zurückgegeben, dieenUs
(Englisch, USA),frFr
(Französisch, Frankreich),guLatn
(Gujarati, lateinische Schrift) usw. enthalten.Diese Funktion gibt auch Modellkennungen zurück, die eine Obermenge des angegebenen Skript-Subtags unterstützen. Beispiel: Für
Hant
(Han, traditionelle Variante) gibt diese Funktion diezh-Hani
-Erkennungsmodelle zurück, daHant
eine Teilmenge vonHani
ist (Han, sowohl traditionelle als auch vereinfachte Varianten).Wenn keine Modellkennungen gefunden werden, die das Skript-Subtag unterstützen, wird ein leerer Satz zurückgegeben.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;
Parameter
scriptSubtag
Ein aus vier Buchstaben bestehender ISO 15924-Standardcode, z.B.
"Latn"
für lateinische Schrift oder"Arab"
für arabische Schrift.Rückgabewert
Eine Reihe von Modellkennungen, die den angegebenen
scriptSubtag
unterstützen, kann leer sein. -
Gibt den Satz von Modellkennungen zurück, die für das angegebene Regions-Subtag spezifisch sind.
Für
"CH"
wird beispielsweise eine Reihe von Modellkennungen zurückgegeben, diedeCh
(Deutsch, Schweiz),frCh
(Französisch, Schweiz),itCh
(Italienisch, Schweiz) undrmCh
(Romanisch, Schweiz) enthalten.Diese Funktion gibt auch Modellkennungen zurück, die für Regionen spezifisch sind, die das angegebene Regions-Subtag enthalten oder in diesem enthalten sind. Wenn Sie beispielsweise nach
DZ
(Algerien) suchen, erhalten Sie Ergebnisse, die das Erkennungsmodellfr-002
(Französisch, Afrika) enthalten und umgekehrt.Wenn keine Modellkennungen gefunden werden, die das Subtag für die Region unterstützen, wird ein leerer Satz zurückgegeben.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;
Parameter
regionSubtag
Ein aus zwei Buchstaben bestehender ISO 3166-1 Alpha 2-Standard-Regionscode oder einer der durch UN M.49 definierten numerischen Codes, z.B.
"DE"
für Deutschland oder"002"
für Afrika.Rückgabewert
Eine Reihe von Modellkennungen, die für die angegebene
regionSubtag
spezifisch sind, kann leer sein.