Saltar al contenido

Funciones de Cadena

Las funciones de cadena son el mecanismo para la manipulación de cadenas en secuencias de comandos.

CountSubString

Declaración

int CountSubString(string str, string subStr)

Sintaxis

CountSubString(<str>, <subStr>)

Parámetros Requeridos

  • str: Una cadena para buscar
  • subStr: La cadena con la que buscar

Descripción

Devuelve el número de veces que aparece una subcadena en una cadena.

Ejemplos

CountSubString("Mississippi", "iss"); // Returns 2

DQuote

Declaración

string DQuote(string str)

Sintaxis

DQuote(<str>)

Parámetros Requeridos

  • str: Una cadena entre comillas dobles

Descripción

Coloca una cadena entre comillas dobles y devuelve el resultado. Las comillas dobles incrustadas no se escapan.

Ejemplos

DQuote("any str"); // Returns ""any str""

DQuote('any "text" str');
// Returns ""any "text" str"" -- note that the embedded double quotes are not escaped

Nota

El par exterior de comillas dobles en los ejemplos anteriores es la indicación de un tipo de datos de cadena y no se devuelve como parte de la propia cadena.

Format

Declaración

string Format(string formatStr, type de)

Sintaxis

Format(<formatStr>, <de>)

Parámetros Requeridos

  • formatStr: La cadena de formato que se usará al formatear la cadena
  • de: Un elemento de datos; si es necesario, se convertirá en una cadena antes de formatearlo

Descripción

Devuelve una cadena en el formato especificado por una cadena de formato.

La especificación de formato es la misma que se usa en las Funciones de fecha y hora; ver su sección sobre cadenas de formato. Es similar a la biblioteca C estándar printf especificación de formato.

Esta función se puede utilizar para establecer el formato de salida para un objetivo. Es útil cuando el formato de salida predeterminado de Jitterbit para un tipo de datos (como fecha o doble) no es el deseado. la llamada a la Format la función debe ser la última llamada en una fórmula de asignación para que sea el valor asignado.

Ejemplos

Format("'%5d'", 2); // Returns "'    2'"

Index

Declaración

int Index(string str, string subStr[, int n])

Sintaxis

Index(<str>, <subStr>[, <n>])

Parámetros Requeridos

  • str: Una cadena para buscar
  • subStr: La cadena con la que buscar

Parámetros Opcionales

  • n: La instancia específica de interés si hay más de una coincidencia

Descripción

Devuelve la posición de una subcadena dentro de una cadena.

En los casos en que la subcadena aparece más de una vez en la cadena principal, el tercer argumento (n) se utiliza para determinar qué instancia específica de la subcadena es de interés.

  • Si n < 0, el recuento de instancias comienza desde el final de la cadena principal.
  • Si |n| > el número máximo de veces que aparece la subcadena en la cadena principal, la función devuelve -1.

De lo contrario, la función devuelve la posición del primer carácter de la subcadena dentro de la cadena principal (comenzando en la posición 0).

Casos especiales a considerar:

  • N = 0 devuelve el mismo resultado que n = 1
  • Si subStr es una cadena vacía (""):
    • n >= 0 siempre devuelve 0
    • n \< 0 siempre regresa Length(str)

Ejemplos

Index("Mississippi", "s"); // Returns 2
// When called with only two arguments
// the optional third argument defaults to 1,
// resulting in the index of the first match being returned

Index("Mississippi", "iss", 3); // Returns -1
// Searching for the 3rd instance of "iss" within Mississippi

Index("Mississippi", "si", 2); // Returns 6
// The 2nd instance of the sub-string
// "si" starts at position 6 as the
// first letter "M" starts at position 0

Index("Mississippi", "", 1); // Returns 0
Index("Mississippi", "", -1); // Returns 11

IsValidString

Declaración

bool IsValidString(string str)

Sintaxis

IsValidString(<str>)

Parámetros Requeridos

  • str: Una cadena para ser validada

Descripción

Devuelve verdadero si cada carácter de una cadena es válido. Los caracteres válidos son los códigos ASCII del 32 al 126 inclusive y cualquiera de los caracteres de avance de línea (LF), retorno de carro (CR) o pestaña (TAB).

Ejemplos

IsValidString("An Invalid String™");
// Returns 0 (false), as the trademark symbol in this font is a code greater than 128

IsValidString("A Valid Broken
String");
// Returns 1 (true)

Left

Declaración

string Left(string str, int n)

Sintaxis

Left(<str>, <n>)

Parámetros Requeridos

  • str: Una cuerda
  • n: El número de caracteres del extremo izquierdo que se devolverán

Descripción

Devoluciones n caracteres de una cadena, contando desde la izquierda (el principio) de una cadena.

Véase también el Mid y Right funciones

Nota

Si la cadena es una cadena numérica que comienza con un cero inicial, debe estar entre comillas o se interpretará como un número entero y puede resultar en un índice de carácter inicial diferente.

Ejemplos

Left("01234567890", 4);
// Returns "0123"

LPad

Declaración

string LPad(string str, int n)

Sintaxis

LPad(<str>, <n>)

Parámetros Requeridos

  • str: Una cuerda
  • n: El número de caracteres del extremo izquierdo que se devolverán

Descripción

Agrega espacios a la izquierda (el comienzo) de una cadena hasta que la cadena contiene n caracteres. Cadenas que contienen n o más caracteres se truncan para n caracteres.

LPad(str, -n) es lo mismo que RPad(str, n). Ver el RPad función.

Ejemplos

LPad("01234567", 9);
// Returns " 01234567"
// Adds one space to the left side
// of the original string

LPad("1234567890", 9);
// Returns "123456789"

LPadChar

Declaración

string LPadChar(string str, string padChar, int n)

Sintaxis

LPadChar(<str>, <padChar>, <n>)

Parámetros Requeridos

  • str: Una cuerda
  • padChar: Una cadena que se usará para rellenar caracteres; si hay más de un carácter, se utiliza el primero
  • n: El número de caracteres del extremo izquierdo que se devolverán

Descripción

Agrega un carácter de relleno a la izquierda (el comienzo) de una cadena hasta que la cadena contiene n caracteres. Cadenas que contienen n o más caracteres se truncan para n caracteres.

LPadChar(str, " ", n) es lo mismo que LPad(str, n). Ver el LPad función.

Ejemplos

LPadChar(1234567, "0", 10);
// Returns "0001234567"
LPadChar(1234567, ".0", 10);
// Returns "...1234567"

LTrim

Declaración

string LTrim(string str)

Sintaxis

LTrim(<str>)

Parámetros Requeridos

  • str: Una cuerda

Descripción

Elimina los espacios en blanco (espacios, tabulaciones) de la izquierda (el comienzo) de una cadena y devuelve los caracteres restantes.

Ejemplos

LTrim(" Hello World!  ");
// Returns "Hello World!  "

LTrim("    Hello World!");
// Removes the leading tab character
// and returns "Hello World!"

LTrimChars

Declaración

string LTrimChars(string str, string trimChars)

Sintaxis

LTrimChars(<str>, <trimChars>)

Parámetros Requeridos

  • str: Una cadena que se recortará desde la izquierda (el principio)**
  • trimChars:** Una cadena de caracteres de recorte para hacer coincidir; El orden no importa

Descripción

Elimina los caracteres iniciales de una cadena desde la izquierda (el principio) que coincidan con los de los caracteres de recorte y devuelve los caracteres restantes.

Esta función prueba cada carácter inicial de una cadena, comenzando en el borde izquierdo, y ve si se encuentra en los caracteres de corte. Si lo hace, se elimina y el proceso se repite hasta que ya no hay una coincidencia.

Esto se puede usar para recortar caracteres que no sean los espacios en blanco predeterminados, como recortar los dos puntos iniciales.

Véase también el RTrimChars y TrimChars funciones

Ejemplos

LTrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg::"

LTrimChars("// This is a comment", " /");
// Returns "This is a comment"

LTrimChars("// This is a comment", "/ ");
// Returns "This is a comment"

LTrimChars("// This is a comment", "/");
// Returns " This is a comment"

LTrimChars("// This is a comment", " ");
// Returns "// This is a comment"
// Returns the string unchanged as a space
// was not a leading character

Mid

Declaración

string Mid(string str, int m, int n)

Sintaxis

Mid(<str>, <m>, <n>)

Parámetros Requeridos

  • str: Una cadena de la que extraer una subcadena

  • m: La posición del carácter inicial basado en cero para comenzar a extraer la subcadena

  • n: La longitud (número de caracteres) de la subcadena que se extraerá

Descripción

Devuelve una parte de una cadena, comenzando con el carácter en la posición m por una longitud de n caracteres.

Véase también el Left y Right funciones

Nota

Si la cadena es una cadena numérica que comienza con un cero inicial, debe estar entre comillas o se interpretará como un número entero y puede resultar en un índice de carácter inicial diferente.

Ejemplos

Mid("Jitterbit", 2, 3);
// Returns "tte"

Mid("01234567890", 7, 3);
// Returns "789"

// Passing the same string as an
// integer with a leading zero
// returns a different result
Mid(01234567890, 7, 3);
// Returns "890"

ParseURL

Declaración

array ParseURL(string url)

Sintaxis

ParseURL(<url>)

Parámetros Requeridos

  • url: Una cadena que contiene una URL para analizar

Descripción

Analiza una cadena de URL y devuelve una matriz de valores decodificados. Los valores están etiquetados para que puedan recuperarse por índice o por nombre de campo.

Al recuperar valores del resultado, se ignoran las mayúsculas y minúsculas de un nombre de campo. Véase también el URLDecode y URLEncode funciones

Ejemplos

url = "http://hostname/user?email=john1990%40example.com&name=John%20Smith";
arr = ParseURL(url);

email = arr[0];
// "email" will be john1990@example.com
email = arr["email"];
// same as previous

name = arr["name"];
// "name" will be "John Smith"
name = arr["Name"];
// Same as previous;
// case is ignored for field names

Quote

Declaración

string Quote(string str)

Sintaxis

Quote(<str>)

Parámetros Requeridos

  • str: Una cadena entre comillas simples

Descripción

Coloca una cadena entre comillas simples y devuelve el resultado. Las comillas simples incrustadas no se escapan.

Ejemplos

Quote("Any string");
// Returns "'Any string'"

Quote("Ain't escaped");
// Returns "'Ain't escaped'" -- note that the embedded quote is not escaped

Nota

El par exterior de comillas dobles en los ejemplos anteriores es la indicación de un tipo de datos de cadena y no se devuelve como parte de la propia cadena.

RegExMatch

Declaración

int RegExMatch(string str, string exp[, type var1,... type varN])

Sintaxis

RegExMatch(<str>, <exp>[, <var1>,... <varN>])

Parámetros Requeridos

  • str: Una cadena entre comillas simples

  • exp: Una expresión regular que consta de grupos

Parámetros Opcionales

  • var1...varN: Uno o más nombres de variables, para que coincidan con las subexpresiones marcadas de la expresión

Descripción

Hace coincidir una expresión regular con una cadena de entrada, almacena las subexpresiones marcadas en variables y devuelve el número de coincidencias.

Devuelve el número total de subexpresiones marcadas (que puede ser mayor o menor que el número de variables realmente proporcionadas). Se descartan todas las coincidencias adicionales que excedan el número de variables proporcionadas. Si no hay coincidencias, -1 es regresado.

La expresión regular sigue la sintaxis de la biblioteca de expresiones regulares Boost. Es una variación de la sintaxis de expresiones regulares de Perl.

Los caracteres Unicode, incluidos símbolos como emoji, deben coincidir con sus caracteres literales y no con secuencias de escape Unicode. Por ejemplo, el rango "[😀-🤯]" (U+1F600 a U+1F92F) captura con éxito el símbolo 🤔 (U+1F914) en el medio.

Véase también el RegExReplace función.

Ejemplos

result = RegExMatch("[abc]", "(\\[)(.*)(\\])", "dummy", "value");
// Sets the global variable "$dummy" to "[".
// Sets the global variable "$value" to "abc".
// Returns 3 because the character "]"
// also matched the last sub-expression.
// However, as there are only two variable names,
// the last match is not saved to a variable.

Nota

"\" (barra invertida) tiene que escaparse en cadenas literales ya que es el carácter de escape. para usar un "\", use una barra invertida doble: "\\".

RegExReplace

Declaración

string RegExReplace(string str, string exp, string format)

Sintaxis

RegExReplace(<str>, <exp>, <format>)

Parámetros Requeridos

Descripción

Reemplaza todas las subcadenas en una cadena que coinciden con una expresión, utilizando un formato especificado para reemplazar cada subcadena. Cualquier sección de la cadena que no coincida con la expresión se pasa a la cadena devuelta sin cambios.

La expresión regular sigue la sintaxis de la biblioteca de expresiones regulares Boost. Es una variación de la sintaxis de expresiones regulares de Perl.

Los caracteres Unicode, incluidos símbolos como emoji, deben coincidir con sus caracteres literales y no con secuencias de escape Unicode. Por ejemplo, el rango "[😀-🤯]" (U+1F600 a U+1F92F) captura con éxito el símbolo 🤔 (U+1F914) en el medio.

La cadena de formato sigue la Sintaxis de cadena de formato ampliado de Boost. Si la cadena de formato es una cadena vacía (""), entonces una coincidencia no produce ningún resultado para esa subcadena.

Véase también el RegExMatch función.

Ejemplos

// To remove any whitespace from a string:
RegExReplace(" t e st ss s", "\\s", "");
// Returns "testsss"

// To swap the order of sub-strings:
RegExReplace("abc(first)123(second)xyz",
             "(.*)(\\(.*\\))(.*)(\\(.*\\))(.*)",
             "\\1aaa\\4\\2\\3\\5");
// Returns "abcaaa(second)(first)123xyz"

// To pass backslashes in matches, multiple instances may be required.
// In the "r" example, three backslashes are used and then doubled.
// The first two backslashes convert into a single backslash,
// which then escapes the next backslash.
// All three backslashes are then doubled for Jitterbit script.
s = "test\\ing";  // "test\ing";
t = RegExReplace(s, "\\\\", "!");  // "test\ing" -> "test!ing"
r = RegExReplace(t, "!", "\\\\\\");  // "test!ing" ->  "test\\ing"

Nota

"\" (barra invertida) tiene que escaparse en cadenas literales ya que es el carácter de escape. para usar un "\", use una barra invertida doble: "\\".

Replace

Declaración

string Replace(string str, string old, string new)

Sintaxis

Replace(<str>, <old>, <new>)

Parámetros Requeridos

  • str: Una cadena para buscar y las subcadenas coincidentes reemplazadas

  • old: Una cadena que se usará para el partido

  • new: Una cadena que se usará como reemplazo de cualquier coincidencia encontrada

Descripción

Busca en una cadena subcadenas que coincidan con el argumento "antiguo" y reemplaza una subcadena coincidente con el argumento "nuevo".

Para operaciones de búsqueda y reemplazo más complejas, consulte el RegExReplace función.

Ejemplos

Replace("Monday Tuesday", "day", "day night,");
// Returns "Monday night, Tuesday night,"

Right

Declaración

string Right(string str, int n)

Sintaxis

Right(<str>, <n>)

Parámetros Requeridos

  • str: Una cuerda

  • n: El número de caracteres del extremo derecho que se devolverán

Descripción

Devoluciones n caracteres de una cadena, contando desde la derecha (el final) de una cadena.

Véase también el Left y Mid funciones

Nota

Si la cadena es una cadena numérica que comienza con un cero inicial, debe estar entre comillas o se interpretará como un número entero y puede resultar en un índice de carácter inicial diferente.

Ejemplos

Right("01234567890",4);
// Returns "7890"

RPad

Declaración

string RPad(string s, int n)

Sintaxis

string RPad(string s, int n)

Parámetros Requeridos

  • str: Una cuerda

  • n: El número de caracteres del extremo derecho que se devolverán

Descripción

Agrega espacios a la derecha (el final) de una cadena hasta que la cadena contiene n caracteres. Cadenas que contienen n o más caracteres se truncan para n caracteres.

RPad(str, -n) es lo mismo que LPad(str, n). Ver el LPad función.

Ejemplos

RPad("01234567",9);
// Returns "01234567 "

RPadChar

Declaración

string RPadChar(string str, string padChar, int n)

Sintaxis

RPadChar(<str>, <padChar>, <n>)

Parámetros Requeridos

  • str: Una cuerda
  • padChar: Una cadena que se usará para rellenar caracteres; si hay más de un carácter, se utiliza el primero
  • n: El número de caracteres del extremo derecho que se devolverán

Descripción

Agrega un carácter de relleno a la derecha (el final) de una cadena hasta que la cadena contiene n caracteres. Cadenas que contienen n o más caracteres se truncan para n caracteres.

RPadChar(str, " ", n) es lo mismo que RPad(str, n). Ver el RPad función.

Ejemplos

RPadChar(1234567, "0", 10);
// Returns "1234567000"

RTrim

Declaración

string RTrim(string str)

Sintaxis

RTrim(<str>)

Parámetros Requeridos

  • str: Una cuerda

Descripción

Elimina los espacios en blanco (espacios, tabulaciones) de la derecha (el final) de una cadena y devuelve los caracteres restantes.

Ejemplos

RTrim(" Hello World!  ");
// Returns " Hello World!"

RTrim("Hello World!    ");
// Removes the trailing tab character
// and returns "Hello World!"

RTrimChars

Declaración

string RTrimChars(string str, string trimChars)

Sintaxis

RTrimChars(<str>, <trimChars>)

Parámetros Requeridos

  • str: Una cuerda, para ser recortada desde la derecha (el final)**
  • trimChars:** Una cadena de caracteres de recorte para hacer coincidir; El orden no importa

Descripción

Elimina los caracteres finales de una cadena del final que coincidan con los de los caracteres de recorte y devuelve los caracteres restantes.

Esta función prueba cada carácter final de una cadena, comenzando en el borde derecho, y ve si se encuentra en los caracteres de recorte. Si lo hace, se elimina y el proceso se repite hasta que ya no hay una coincidencia.

Esto se puede usar para recortar caracteres que no sean los espacios en blanco predeterminados, como recortar los dos puntos finales.

Véase también el LTrimChars y TrimChars funciones

Ejemplos

RTrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "::StartMsg :: Hello :: EndMsg"

RTrimChars("// This is a comment //", " /");
// Returns "// This is a comment"

RTrimChars("// This is a comment //", "/");
// Returns "// This is a comment "

RTrimChars("// This is a comment //", " ");
// Returns "// This is a comment //"
// Returns the string unchanged as a space
// was not a trailing character

Split

Declaración

array Split(string str, string delimiter)

Sintaxis

Split(<str>, <delimiter>)

Parámetros Requeridos

  • str: Una cadena para dividir
  • delimiter: Una cadena de para que coincida como la división entre cada elemento de la matriz

Descripción

Divide una cadena utilizando una cadena delimitadora y devuelve el resultado como una matriz.

Devuelve el resultado en una matriz de tamaño igual al número de delimitadores más uno. Si la expresión termina con el delimitador, el tamaño de la matriz es igual al número de delimitadores (se ignora el último valor vacío). Si la cadena no contiene delimitadores, se devuelve una matriz de tamaño uno que contiene la cadena original.

Ejemplos

arr = Split("Donald,Minnie,Goofy", ",");
donald = arr[0];
minnie = arr[1];
goofy = arr[2];

Split("Donald.,Minnie.,Goofy.,", ".,");
// Returns the array {Donald, Minnie, Goofy}

Este ejemplo convierte una dirección IP ("10.6.10.1") a un solo entero (168167937):

// Logic: (first octet * 16777216) + (second octet * 65536) +
//   (third octet * 256) + (fourth octet)
ip = "10.6.10.1";
ipList = Split(ip, ".");
(Int(ipList[0]) * 16777216) + (Int(ipList[1]) * 65536) +
    (Int(ipList[2]) * 256) + (Int(ipList[3]));

SplitCSV

Declaración

array Split(string str[, string delimiter, int qualifier])

Sintaxis

Split(<str>[, <delimiter>, <qualifier>])

Parámetros Requeridos

  • str: Una cadena para dividir

Parámetros Opcionales

  • delimiter: Una cadena de para que coincida como la división entre cada elemento de la matriz
  • qualifier: Una cadena de para que coincida como la división entre cada elemento de la matriz

Descripción

Divide una cadena con formato CSV y devuelve una matriz con los valores de las columnas individuales.

De forma predeterminada, el delimitador es una coma (,) y el calificador de cadena es una comilla doble ("). Esto se puede cambiar especificando el segundo y el tercer argumento opcionales, respectivamente.

Nota

Los parámetros opcionales (delimitador y calificador) se pueden especificar con un número entero correspondiente al código ASCII del carácter delimitador o calificador.

Ejemplos

arr = SplitCSV('"Donald","Minnie ""The Mouse""", Goofy');
donald = arr[0];
// Returns "Donald"
minnie = arr[1];
// Returns "Minnie ""The Mouse"""
goofy = arr[2];
// Returns "Goofy"

StringLength

Declaración

int StringLength(string str)

array StringLength(array arr)

Sintaxis

StringLength(string str)

StringLength(array arr)

Parámetros Requeridos

  • str: (Primera forma) Una cadena

  • arr: (Segunda forma) Una matriz

Descripción

Devuelve la longitud de una cadena.

La función devuelve una matriz si el argumento es una matriz, y cada elemento de la matriz devuelta tiene la longitud del elemento correspondiente de la matriz del argumento. El Length la función devuelve la longitud de una matriz en lugar de la longitud de los elementos individuales.

Ejemplos

arr = {a="abcd", b="e"};

StringLength(arr);
// Returns the array {4,1}

Length(arr);
// Returns 2

ToLower

Declaración

string ToLower(string str)

Sintaxis

ToLower(<str>)

Parámetros Requeridos

  • str: Una cuerda

Descripción

Convierte todos los caracteres ASCII en mayúsculas (A a Z, ASCII 65 a 90) en una cadena a minúsculas.

Ejemplos

ToLower("Hello World!");
// Returns "hello world!"

ToProper

Declaración

string ToProper(string str)

Sintaxis

ToProper(<str>)

Parámetros Requeridos

  • str: Una cuerda

Descripción

Convierte una cadena a mayúsculas y minúsculas (la primera letra de cada palabra en mayúscula). Esto es distinto del caso del título, que solo escribe en mayúscula las palabras seleccionadas y más largas en una cadena.

Advertencia

El ToProper() función es tal que nombres como "mccartney" empezando con "mc" sólo se convierten correctamente a "McCartney" si la palabra va precedida de un carácter de espacio. Para tener una cadena que comienza con "mc" como "mccartney, paul" convertido correctamente a "McCartney, Paul", use un código como este para agregar un espacio anterior y luego eliminarlo inmediatamente:

s = "mccartney, paul";
s = Right( ToProper( " " + s), Length(s));

Ejemplos

ToProper("bob dylan");
// Returns "Bob Dylan"
ToProper("arthur c. Clarke");
// Returns "Arthur C. Clarke"
ToProper("Peter o'toole");
// Returns "Peter O'Toole"

ToUpper

Declaración

string ToUpper(string <str>)

Sintaxis

ToUpper(<str>)

Parámetros Requeridos

  • str: Una cuerda

Descripción

Convierte todos los caracteres ASCII en minúsculas (de la a a la z, ASCII 97 a 122) en una cadena a mayúsculas.

Ejemplos

ToUpper("Hello World!");
// Returns "HELLO WORLD!"

Trim

Declaración

string Trim(string str)

Sintaxis

Trim(<str>)

Parámetros Requeridos

  • str: Una cuerda

Descripción

Elimina los espacios en blanco al principio y al final de una cadena y devuelve los caracteres restantes.

Ejemplos

Trim(" Hello World! ");
// Returns "Hello World!"

TrimChars

Declaración

string TrimChars(string str, string trimChars)

Sintaxis

TrimChars(<str>, <trimChars>)

Parámetros Requeridos

  • str: Una cuerda para ser recortada
  • trimChars: Una cadena de caracteres de recorte para hacer coincidir; El orden no importa

Descripción

Elimina los caracteres iniciales o finales de una cadena que coincidan con los de los caracteres de recorte y devuelve los caracteres restantes.

Esta función prueba cada carácter inicial y final de una cadena y ve si se encuentra en los caracteres de corte. Si lo hace, se elimina y el proceso se repite hasta que ya no haya coincidencias.

Esto se puede usar para recortar caracteres que no sean los espacios en blanco predeterminados, como recortar dos puntos.

Ver también el LTrimChars y RTrimChars funciones.

Ejemplos

TrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg"

TrimChars("/* This is a comment */", " /*");
// Returns "This is a comment"

Truncate

Declaración

string Truncate(string str, int firstChars, int lastChars)

Sintaxis

Truncate(<str>, <firstChars>, <lastChars>)

Parámetros Requeridos

  • str: Una cuerda
  • firstChars: El número de caracteres a eliminar desde la izquierda (el principio) de la cadena
  • lastChars: El número de caracteres a eliminar desde la derecha (el final) de la cadena

Descripción

elimina firstChar caracteres de la izquierda (el principio) y lastChars caracteres desde la derecha (el final) de una cadena y devuelve la cadena restante.

Véase también el Left y Right funciones

Ejemplos

Truncate("a,b,c,", 2, 1);
// Returns "b,c"

URLDecode

Declaración

string URLDecode(string url, string paramName)

Sintaxis

URLDecode(<url>, <paramName>)

Parámetros Requeridos

  • url: Una cadena que contiene una URL
  • paramName: El nombre de un parámetro en la URL cuyo valor se devolverá

Descripción

Analice una cadena de URL y devuelva el valor decodificado del parámetro de URL con el nombre especificado. Se ignora el caso del nombre. Si el nombre no se encuentra en los parámetros de la URL, una cadena vacía ("") es regresado.

Véase también el ParseURL y URLEncode funciones

Ejemplos

url = "http://hostname/user?email=john1990%40gmail.com&name=John%20Smith";
URLDecode(url, "name");
// Returns "John Smith"

URLEncode

Declaración

string URLEncode(string str[, int encodingOption])

Sintaxis

URLEncode(<str>[, <encodingOption>])

Parámetros Requeridos

  • url: Una cadena que contiene un valor para codificar siguiendo las reglas de RFC 1738

Parámetros Opcionales

  • encodingOption: Un número entero (0 - 3) que especifica la codificación que se utilizará. El valor predeterminado es 0. Consulte la lista a continuación.

Descripción

Codifica una cadena siguiendo RFC 1738.

Los valores válidos para la opción de codificación opcional son:

  • 0: Codificación de URL estándar. Codifica caracteres de control ASCII, caracteres que no son ASCII, caracteres "reservados" y caracteres "inseguros". Esta es la codificación predeterminada si se omite la opción.
  • 1: No codificar caracteres "inseguros": " \< ;> ; # % { } | \ ^ \~ [ ] ` and the space character
  • 2: Don't encode "reserved" characters: ; / ? : @ & =
  • 3: Don't encode "unsafe" characters and "reserved" characters

These characters are considered "safe" and are never encoded: $ - _ . + ! * ' ( ) ,

See also the ParseURL and Funciones URLDecode.

Ejemplos

value1 = "FIRST#"; value2 = "<LAST>";
url = "http://hostname/get_doc?" +
    "name1=" + URLEncode(value1) +
    "&name2=" + URLEncode(value2);
// Returns
// http://hostname/get_doc?name1=FIRST%23&name2=%3CLAST%3E