MLKDigitalInkRecognitionModelIdentifier
@interface MLKDigitalInkRecognitionModelIdentifier : NSObject
Rappresenta un modello di riconoscimento dell'inchiostro digitale specifico per una lingua, una scrittura e, facoltativamente, una variante regionale.
-
Tag della lingua conforme a BCP 47 per questo modello.
Dichiarazione
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageTag;
-
Sottotag della lingua, ovvero il codice lingua ISO 639 a due o tre lettere per questo modello di riconoscimento, ad esempio
"en"
per l'inglese.Dichiarazione
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
-
Sottotag dello script, ovvero il codice standard ISO 15924 di quattro lettere della scrittura utilizzata in questo modello di riconoscimento, ad esempio
"Latn"
per l'alfabeto latino o"Arab"
per l'alfabeto arabo.Dichiarazione
Objective-C
@property (nonatomic, readonly, nullable) NSString *scriptSubtag;
-
Sottotag regione, ovvero i codici regione a due lettere dello standard ISO 3166-1 Alpha 2 o l'insieme di codici numerici definiti dallo standard UN M.49, ad esempio
"DE"
per la Germania o"002"
per l'Africa.Dichiarazione
Objective-C
@property (nonatomic, readonly, nullable) NSString *regionSubtag;
-
Usa invece il criterio
from(languageTag:)
.Dichiarazione
Objective-C
- (nonnull instancetype)init;
-
Restituisce l'identificatore di modello che meglio corrisponde alla lingua, allo script (se presente) e alla regione (se presente) codificati nel formato
languageTag
di BCP 47.La corrispondenza è del tipo best effort, ovvero restituisce l'identificatore del modello che corrisponde meglio al valore
languageTag
fornito utilizzando la seguente euristica:- Se non è possibile trovare alcun identificatore di modello per il sottotag della lingua richiesto, ma il secondo fa parte di una macrolingua supportata, la corrispondenza con la macrolingua, ad esempio
"arb"
(arabo standard) corrisponderà a"ar"
(arabo).- Se non viene fornito alcuno script e nessuno di questi è implicito per il sottotag della lingua richiesto, effettua una corrispondenza con qualsiasi script.
- Se il sottotag dello script fornito o implicito è un sottoinsieme di uno script supportato, crea una corrispondenza anche con il secondo, ad esempio
"zh-Hant"
(cinese, han tradizionale) corrisponderà a"zh-Hani"
(cinese, han).- Se non viene specificato alcun sottotag della regione, cerca una corrispondenza con qualsiasi regione, dando la preferenza agli identificatori di modello che non specificano anche una regione, ad esempio
"ro"
(rumeno) corrisponderà a"ro-RO"
(rumeno, Romania).- Se viene specificato un sottotag della regione, ma non è possibile trovare una corrispondenza, la corrispondenza con le regioni contenenti la regione specificata, ad esempio
"fr-DZ"
(francese, Algeria) corrisponderà a"fr-002"
(francese, Africa).Se non è possibile trovare alcun identificatore del modello, restituisce
nil
.Dichiarazione
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag error:(NSError *_Nullable *_Nullable)error;
Parametri
languageTag
Un tag di lingua IETF BCP 47 che rappresenta la lingua richiesta.
error
L'oggetto del messaggio di errore facoltativo verrà completato se non è possibile analizzare il valore
languageTag
.Valore restituito
un identificatore del modello che corrisponde esattamente al tag lingua fornito, la migliore corrispondenza approssimativa oppure
nil
se non è possibile trovare un identificatore di modello appropriato. Impostato anche sunil
se non è stato possibile analizzare il tag della lingua. - Se non è possibile trovare alcun identificatore di modello per il sottotag della lingua richiesto, ma il secondo fa parte di una macrolingua supportata, la corrispondenza con la macrolingua, ad esempio
-
Restituisce un identificatore del modello che corrisponde esattamente al valore
languageTag
specificato.Differisce da
from(LanguageTag:)
per il fatto che non tenta di analizzarelanguageTag
(e quindi non genera errori) e restituisce solo l'identificatore del modello che corrisponde esattamente alanguageTag
, se esistente.Dichiarazione
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;
Parametri
languageTag
Il tag di lingua IETF BCP 47 dell'identificatore del modello richiesto.
Valore restituito
Un elemento
DigitalInkRecognitionModelIdentifier
che corrisponde esattamente al valorelanguageTag
fornito onil
se non ne è stato trovato nessuno. -
Restituisce l'insieme di tutti gli identificatori di modello disponibili.
Dichiarazione
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) allModelIdentifiers;
-
Restituisce l'insieme di identificatori di modello che supportano il sottotag della lingua specificato.
Ad esempio, per
"en"
, verrà restituito un insieme di identificatori di modello contenentienUs
(inglese, Stati Uniti),enUk
(inglese, Regno Unito),enKe
(inglese, Kenya) e così via.Se non vengono trovati identificatori di modello che supportano il sottotag della lingua, viene restituito un set vuoto.
Dichiarazione
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;
Parametri
languageSubtag
Un codice lingua ISO 639 di 2 o 3 lettere, ad esempio
"en"
per l'inglese.Valore restituito
Un insieme di identificatori di modello che supportano il valore
languageSubtag
fornito potrebbe essere vuoto. -
Restituisce l'insieme di identificatori di modello che supportano il sottotag dello script specificato.
Ad esempio, per
"Latn"
, verrebbe restituito un insieme di identificatori di modello contenentienUs
(inglese, Stati Uniti),frFr
(francese, Francia),guLatn
(gujarati, alfabeto latino) e così via.Questa funzione restituisce anche identificatori di modello che supportano un soprainsieme del sottotag dello script specificato. Ad esempio, per
Hant
(Han, variante tradizionale), questa funzione restituirà i modelli di riconoscimentozh-Hani
poichéHant
è un sottoinsieme diHani
(Han, varianti tradizionali e semplificate).Se non vengono trovati identificatori di modello che supportano il sottotag dello script, restituisce un set vuoto.
Dichiarazione
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;
Parametri
scriptSubtag
Un codice standard ISO 15924 di quattro lettere, ad esempio
"Latn"
per l'alfabeto latino o"Arab"
per l'alfabeto arabo.Valore restituito
Un insieme di identificatori di modello che supportano il valore
scriptSubtag
fornito potrebbe essere vuoto. -
Restituisce l'insieme di identificatori di modello specifici per il sottotag della regione specificato.
Ad esempio, per
"CH"
, verrà restituito un insieme di identificatori di modello contenentideCh
(tedesco, Svizzera),frCh
(francese, Svizzera),itCh
(italiano, Svizzera) ermCh
(romancio, Svizzera).Questa funzione restituisce anche identificatori di modello specifici per le regioni che contengono il sottotag della regione specificato o che sono contenuti nel sottotag della regione specificato, ad esempio la ricerca di
DZ
(Algeria) produrrà risultati che includono il modello di riconoscimentofr-002
(francese, Africa) e viceversa.Se non vengono trovati identificatori di modello che supportano il sottotag regione, restituisce un set vuoto.
Dichiarazione
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;
Parametri
regionSubtag
Un codice regione standard ISO 3166-1 Alpha 2 a due lettere o uno dei codici numerici definiti dallo standard UN M.49, ad esempio
"DE"
per la Germania o"002"
per l'Africa.Valore restituito
Un insieme di identificatori di modello specifici per l'elemento
regionSubtag
fornito può essere vuoto.