Share via


Método WorksheetFunction.SearchB (Excel)

Busque y SearchB busque una cadena de texto dentro de una segunda cadena de texto y devuelva el número de la posición inicial de la primera cadena de texto del primer carácter de la segunda cadena de texto.

Sintaxis

expresión. SearchB (Arg1, Arg2, Arg3)

Expresión Variable que representa un objeto WorksheetFunction .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Arg1 Obligatorio String Find_text: el texto que desea encontrar.
Arg2 Obligatorio String Dentro del texto: texto en el que se desea localizar el texto buscado.
Arg3 Opcional Variant Número inicial: número de carácter correspondiente del argumento de dentro del texto donde desea iniciar la búsqueda.

Valor devuelto

Double

Comentarios

La búsqueda está pensada para usarse con idiomas que usan el conjunto de caracteres de un solo byte (SBCS), mientras que SearchB está pensado para usarse con idiomas que usan el juego de caracteres de doble byte (DBCS). La configuración predeterminada de idioma del equipo influye en el valor devuelto de la siguiente manera:

  • La búsqueda siempre cuenta cada carácter, ya sea de un solo byte o de doble byte, como 1, independientemente de cuál sea la configuración de idioma predeterminada.

  • SearchB cuenta cada carácter de doble byte como 2 cuando se ha habilitado la edición de un idioma que admite DBCS y, a continuación, se establece como el idioma predeterminado. De lo contrario, SearchB cuenta cada carácter como 1.

  • Entre los idiomas que admiten DBCS se incluyen japonés, chino (simplificado), chino (tradicional) y coreano.

Use Search y SearchB para determinar la ubicación de un carácter o cadena de texto dentro de otra cadena de texto de modo que pueda usar las funciones Mid y MidB o Replace y ReplaceB para cambiar el texto.

Search y SearchB no distinguen mayúsculas de minúsculas. Si desea realizar una búsqueda que distinga mayúsculas de minúsculas, puede usar Buscar y BuscarB.

Use los caracteres comodín, signo de interrogación (?) y asterisco (*), en find_text. El símbolo de interrogación corresponde a cualquier carácter único, mientras que un asterisco corresponde a cualquier secuencia de caracteres. Si desea buscar un signo de interrogación o asterisco reales, escriba una tilde (~) delante del carácter.

Si no se encuentra find_text, el #VALUE! se devuelve el valor de error.

Si se omite el argumento de número inicial, se supone que es 1.

Si start_num no es mayor que 0 (cero) o es mayor que la longitud de within_text, el #VALUE! se devuelve el valor de error.

Utilice el argumento de número inicial para omitir un número específico de caracteres. Con Search como ejemplo, suponga que está trabajando con la cadena AYF0093.YoungMensApparelde texto . Para buscar el número del primero "Y" en la parte descriptiva de la cadena de texto, establezca start_num igual a 8 para que no se busque en la parte del número de serie del texto. La búsqueda comienza con el carácter 8, busca find_text en el siguiente carácter y devuelve el número 9.

Search siempre devuelve el número de caracteres desde el principio de within_text, contando los caracteres que omite si start_num es mayor que 1.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.