WorksheetFunction.Search(String, String, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Busque y SearchB(String, String, Object) localice 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 a partir del primer carácter de la segunda.
public double Search(string Arg1, string Arg2, object Arg3);Public Function Search (Arg1 As String, Arg2 As String, Optional Arg3 As Object) As DoubleParámetros
- Arg1
- String
Texto buscado: texto que se desea encontrar.
- Arg2
- String
Dentro del texto: texto en el que se desea localizar el texto buscado.
- Arg3
- Object
Número inicial: número de carácter correspondiente del argumento de dentro del texto donde desea iniciar la búsqueda.
Devoluciones
Comentarios
Importante: La búsqueda está pensada para usarse con idiomas que usan el juego de caracteres de un byte (SBCS), mientras SearchB(String, String, Object) que está diseñada para usarse con idiomas que usan el juego de caracteres de doble byte (DBCS). La configuración de idioma predeterminada del equipo influye en el valor devuelto de la siguiente manera:La búsqueda siempre cuenta cada carácter, ya sea de un byte o de doble byte como 1, independientemente de la configuración predeterminada de idioma. SearchB(String, String, Object) cuenta cada carácter de doble byte como 2 si se ha habilitado la edición de un idioma que admita DBCS y posteriormente se establece como idioma predeterminado. De lo contrario, SearchB(String, String, Object) cuenta cada carácter como 1.
Entre los idiomas que admiten DBCS se incluyen japonés, chino (simplificado), chino (tradicional) y coreano.
Use la búsqueda y SearchB(String, String, Object) para determinar la ubicación de un carácter o una cadena de texto dentro de otra cadena de texto, de modo que pueda usar las funciones EXTRAE y EXTRAEB o Replace(String, Double, Double, String) and ReplaceB(String, Double, Double, String) para cambiar el texto.
Buscar y SearchB(String, String, Object) no distinguen entre mayúsculas y minúsculas. Si desea realizar una búsqueda que distinga entre mayúsculas y minúsculas, puede usar Find(String, String, Object) y FindB(String, String, Object).
En el argumento de texto buscado se pueden utilizar los caracteres comodín signo de interrogación (?) y asterisco (*). El signo de interrogación corresponde a un solo carácter cualquiera, y el asterisco equivale 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. Usando la búsqueda como ejemplo, supongamos que está trabajando con la cadena de texto "AYF0093. YoungMensApparel". Para encontrar el número de la primera "A" en la parte descriptiva de la cadena de texto, establezca el argumento de número inicial en 8, de manera que la función no busque en la parte correspondiente al número de serie. La búsqueda comienza con el carácter 8, encuentra find_text en el carácter siguiente y devuelve el número 9. La búsqueda 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.