_strdec, _wcsdec, , _mbsdec, _mbsdec_l

Hace retroceder el puntero de cadena un carácter.

Sintaxis

unsigned char *_strdec(
   const unsigned char *start,
   const unsigned char *current
);
unsigned wchar_t *_wcsdec(
   const unsigned wchar_t *start,
   const unsigned wchar_t *current
);
unsigned char *_mbsdec(
   const unsigned char *start,
   const unsigned char *current
);
unsigned char *_mbsdec_l(
   const unsigned char *start,
   const unsigned char *current,
   _locale_t locale
);

Parámetros

start
Puntero a cualquier carácter (o para _mbsdec y _mbsdec_l, el primer byte de cualquier carácter multibyte) de la cadena de origen; start debe preceder current a la cadena de origen.

current
Puntero a cualquier carácter (o para _mbsdec y _mbsdec_l, el primer byte de cualquier carácter multibyte) de la cadena de origen; current debe seguir start en la cadena de origen.

locale
Configuración regional que se va a usar.

Valor devuelto

_mbsdec, , y cada uno devuelve un puntero al carácter que precede currentinmediatamente a ; _mbsdec devuelve NULL si el valor de start es mayor o igual que el de current._wcsdec _strdec_mbsdec_l los mapas de_tcsdec se asigna a una de estas funciones y el valor que devuelve depende de la asignación.

Comentarios

Las funciones _mbsdec y _mbsdec_l devuelven un puntero al primer byte del carácter multibyte que precede inmediatamente a current en la cadena que contiene start.

El valor de salida se ve afectado por el valor de la categoría LC_CTYPE de la configuración regional. Para más información, vea setlocale, _wsetlocale. _mbsdec reconoce las secuencias de caracteres multibyte de acuerdo con la configuración regional que se usa actualmente; _mbsdec_l es idéntico, salvo que usa el parámetro de configuración regional que se pasa. Para obtener más información, vea Locale.

Si start o current es NULL, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función devuelve EINVAL y establece errno en EINVAL.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

_strdec y _wcsdec son versiones de caracteres de un solo byte y caracteres anchos de _mbsdec y _mbsdec_l. _strdec y _wcsdec solo se proporcionan para esta asignación y no se deben usar de otro modo.

Para obtener más información, consulte Uso de asignaciones de texto genérico y asignaciones de texto genérico.

Requisitos

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

En el siguiente ejemplo, se muestra el uso de _tcsdec.

// crt_tcsdec.cpp
// Compile by using: cl /EHsc crt_tcsdec.cpp
#include <iostream>
#include <tchar.h>
using namespace std;

int main()
{
   const TCHAR *str = _T("12345");
   cout << "str: " << str << endl;

   const TCHAR *str2;
   str2 = str + 2;
   cout << "str2: " << str2 << endl;

   TCHAR *answer;
   answer = _tcsdec( str, str2 );
   cout << "answer: " << answer << endl;

   return (0);
}

En el siguiente ejemplo, se muestra el uso de _mbsdec.

// crt_mbsdec.cpp
// Compile by using: cl /EHsc crt_mbsdec.c
#include <iostream>
#include <mbstring.h>
using namespace std;

int main()
{
   char *str = "12345";
   cout << "str: " << str << endl;

   char *str2;
   str2 = str + 2;
   cout << "str2: " << str2 << endl;

   unsigned char *answer;
   answer = _mbsdec( reinterpret_cast<unsigned char *>( str ), reinterpret_cast<unsigned char *>( str2 ));

   cout << "answer: " << answer << endl;

   return (0);
}

Consulte también

Manipulación de cadenas
_strinc, _wcsinc, , _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, , _mbsnextc, _mbsnextc_l
_strninc, _wcsninc, , _mbsninc, _mbsninc_l