Funciones de cadena (Visual Basic)

En la tabla siguiente se enumeran las funciones que Visual Basic proporciona para buscar y manipular las cadenas.

Método en .NET Framework

Descripción

Asc, AscW

Devuelve un valor de tipo Integer que representa el código de carácter que corresponde a un carácter.

Chr, ChrW

Devuelve el carácter asociado al código de carácter especificado.

Filter

Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.

Format

Devuelve una cadena con el formato que especifiquen las instrucciones contenidas en una expresión String de formato.

FormatCurrency

Devuelve una expresión con formato de moneda en la que se utilizará el símbolo de moneda que se haya definido en el panel de control del sistema.

FormatDateTime

Devuelve una expresión de cadena que representa un valor de fecha u hora.

FormatNumber

Devuelve una expresión con formato de número.

FormatPercent

Devuelve una expresión con formato de porcentaje (multiplicada por 100), acompañada del carácter final %.

InStr

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena dentro de otra.

InStrRev

Devuelve la posición de la primera aparición de una cadena dentro de otra, comenzando por el extremo derecho de la cadena.

Join

Devuelve una cadena creada a partir de la combinación de varias subcadenas contenidas en una matriz.

LCase

Devuelve una cadena o un carácter convertidos en minúscula.

Left

Devuelve una cadena que contiene un número especificado de caracteres a partir del lado izquierdo de una cadena.

Len

Devuelve un entero que contiene el número de caracteres de una cadena.

LSet

Devuelve una cadena alineada a la izquierda que contiene la cadena especificada ajustada a la longitud indicada.

LTrim

Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales.

Mid

Devuelve una cadena que a su vez contiene un número especificado de caracteres de una cadena.

Replace

Devuelve una cadena en la que la subcadena especificada se reemplaza determinado número de veces por otra subcadena.

Right

Devuelve una cadena que contiene un número especificado de caracteres desde el lado derecho de una cadena.

RSet

Devuelve una cadena alineada a la derecha que contiene la cadena especificada y con la longitud especificada.

RTrim

Devuelve una cadena que contiene una copia de una cadena especificada sin espacios finales.

Space

Devuelve una cadena que consta del número especificado de espacios.

Split

Devuelve una matriz unidimensional basada en cero que contiene un número especificado de subcadenas.

StrComp

Devuelve un valor, -1, 0 ó 1, que indica el resultado de una comparación de cadena.

StrConv

Devuelve una cadena convertida según se ha especificado.

StrDup

Devuelve una cadena o un objeto que se compone del carácter especificado repetido el número de veces especificado.

StrReverse

Devuelve una cadena en la que se invierte el orden de los caracteres de la cadena especificada.

Trim

Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales o finales.

UCase

Devuelve una cadena o un carácter que contiene la cadena especificada convertida en mayúsculas.

Puede usar la instrucción Option Compare para establecer si las cadenas se comparan mediante un criterio de ordenación de texto sin distinción entre mayúsculas y minúsculas determinado por la configuración regional del sistema (Text) o por las representaciones binarias internas de los caracteres (Binary). El método predeterminado de comparación de texto es Binary.

Ejemplo

En este ejemplo se utiliza la función UCase para devolver la versión en mayúsculas de una cadena.

' String to convert.
Dim LowerCase As String = "Hello World 1234"
' Returns "HELLO WORLD 1234".
Dim UpperCase As String = UCase(LowerCase)

En este ejemplo se usa la función LTrim para quitar los espacios iniciales y la función RTrim para quitar los espacios finales de una variable de cadena. También se usa la función Trim para quitar ambos tipos de espacios.

' Initializes string.
Dim TestString As String = "  <-Trim->  "
Dim TrimString As String
' Returns "<-Trim->  ".
TrimString = LTrim(TestString)
' Returns "  <-Trim->".
TrimString = RTrim(TestString)
' Returns "<-Trim->".
TrimString = LTrim(RTrim(TestString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
TrimString = Trim(TestString)

En este ejemplo se utiliza la función Mid para devolver un número de caracteres especificado de una cadena.

' Creates text string.
Dim TestString As String = "Mid Function Demo"
' Returns "Mid".
Dim FirstWord As String = Mid(TestString, 1, 3)
' Returns "Demo".
Dim LastWord As String = Mid(TestString, 14, 4)
' Returns "Function Demo".
Dim MidWords As String = Mid(TestString, 5)

En este ejemplo se utiliza Len para devolver el número de caracteres de una cadena:

' Initializes variable.
Dim TestString As String = "Hello World"
' Returns 11.
Dim TestLen As Integer = Len(TestString)

En este ejemplo se usa la función InStr para devolver la posición de la primera aparición de una cadena dentro de otra.

' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"

Dim TestPos As Integer
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

En este ejemplo se muestran los diversos usos de la función Format para dar formato a valores tanto con formatos String como otros definidos por el usuario. Para el separador de fecha (/), hora (:) e indicadores de a.m./p.m. (t y tt), el formato de salida que muestre su sistema dependerá de la configuración regional que use el código. Cuando las horas y fechas se muestren en el entorno de desarrollo, se utilizará el formato de fecha y hora corta de la configuración regional del código.

Nota

Para configuraciones regionales que utilizan un reloj de 24 horas, los indicadores de a.m./p.m. (t y tt) no muestran nada.

Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats.
' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")

Vea también

Referencia

Miembros de la biblioteca en tiempo de ejecución de Visual Basic

Resumen de manipulaciones de cadenas (Visual Basic)

Palabras clave comparadas en varios lenguajes

Otros recursos

Palabras clave de Visual Basic