_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l

  • Artikel

Konvertiert zwischen Zeichen aus den Zeichensätzen Japan Industry Standard (JIS) und Japan Microsoft (JMS).

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

unsigned int _mbcjistojms(
   unsigned int c
);
unsigned int _mbcjistojms_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbcjmstojis(
   unsigned int c
);
unsigned int _mbcjmstojis_l(
   unsigned int c,
   _locale_t locale
);

Parameter

c
Zu konvertierendes Zeichen.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

Bei einem japanischen Gebietsschema geben diese Funktionen ein konvertiertes Zeichen zurück. Wenn keine Konvertierung möglich ist, wir 0 (null) zurückgegeben. Bei einem nicht japanischen Gebietsschema geben diese Funktionen das Zeichen zurück, das übergeben wurde.

Hinweise

Die _mbcjistojms-Funktion konvertiert ein JIS-Zeichen (Japan Industry Standard) in ein Shift JIS-Zeichen (Microsoft Kanji). Das Zeichen wird nur konvertiert, wenn sich die Lead- und Trailbytes im Bereich 0x21 - 0x7E befinden. Wenn das anführende oder das nachfolgende Byte außerhalb dieses Bereichs liegt, wird errno auf EILSEQ festgelegt. Weitere Informationen zu diesem und anderen Fehlercodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Die _mbcjmstojis Funktion konvertiert ein UMSCHALT-JIS-Zeichen in ein JIS-Zeichen. Das Zeichen wird nur konvertiert, wenn sich das Leadbyte im Bereich 0x81 - 0x9F oder 0xE0 - befindet sich 0xFC und das Trailbyte im Bereich 0x40 - 0x7E oder 0x80 - 0xFC. Einige Codepunkte in diesem Bereich weisen kein Zeichen auf und können daher nicht konvertiert werden.

Der Wert c muss ein 16-Bit-Wert sein, dessen obere 8 Bits das führende Byte des zu konvertierenden Zeichens darstellen und dessen untere 8 Bits das nachfolgende Byte darstellen.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieeinstellung des Gebietsschemas beeinflusst. Weitere Informationen finden Sie unter setlocale. Die Versionen dieser Funktionen ohne das _l-Suffix verwenden das aktuelle Gebietsschema für dieses vom Gebietsschema abhängige Verhalten; die Versionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch stattdessen den ihnen übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.

In früheren Versionen _mbcjistojms wurden sie aufgerufen bzwjmstojis_mbcjmstojis. aufgerufenjistojms. _mbcjistojms, _mbcjistojms_l_mbcjmstojis und _mbcjmstojis_l sollte stattdessen verwendet werden.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Routine Erforderlicher Header
_mbcjistojms <mbstring.h>
_mbcjistojms_l <mbstring.h>
_mbcjmstojis <mbstring.h>
_mbcjmstojis_l <mbstring.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Datenkonvertierung
_ismbb Routinen