Funciones en tiempo de ejecución de X++ para cadena

En este artículo se describen las funciones en tiempo de ejecución de cadena.

cerilla

Busca una cadena o expresión en otra cadena.

int match(str pattern, str text)

Parámetros

Valor devuelto

1 si el patrón se encuentra en la cadena; de lo contrario, 0 (cero).

Observaciones

La búsqueda no distingue mayúsculas de minúsculas. Los siguientes caracteres especiales se pueden usar para crear el patrón para el parámetro pattern .

• \: una barra diagonal inversa (\) anula o escapa, el tratamiento especial de caracteres especiales, de modo que un carácter especial pueda coincidir como una letra normal. Un par de barras diagonales inversas se traduce en una barra diagonal inversa no especificada. Ejemplos:

  • match("ab$cd","ab$cd"); devuelve 0.
  • match("ab\$cd","ab$cd"); devuelve 0. La barra diagonal inversa no tiene escape.
  • match("ab\\$cd","ab$cd"); devuelve 1. Las barras diagonales inversas y el signo de dólar se escapan.

• < o ^: se usa un corchete angular izquierdo (<) o un circunflejo (^) al principio de una expresión para que coincida con el inicio de una línea. Ejemplos:

  • match("<abc","abcdef"); devuelve 1.
  • match("<abc","defabc"); devuelve 0.
  • match("^abc","abcdef"); devuelve 1.
  • match("^abc","defabc"); devuelve 0.

• > o $: se usa un corchete angular derecho (>) o un signo de dólar ($) al final de la expresión para que coincida con el final de una línea. Ejemplos:

  • match("abc>","abcdef"); devuelve 0.
  • match("abc>","defabc"); devuelve 1.

• ? o.: un signo de interrogación (?) o un punto (.) coincide con cualquier carácter en la misma posición. Ejemplos:

  • match("abc.def","abc#def"); devuelve 1.
  • match("colou?r","colouXr"); devuelve 1.

• :x: dos puntos (:) especifica un grupo de caracteres que debe coincidir, como se indica en el carácter que sigue inmediatamente.

• :a: establece la coincidencia con letras. Ejemplos:

  • match("ab:acd","ab#cd"); devuelve 0.
  • match("ab:acd","abxyzcd"); devuelve 0.
  • match("ab:acd","abxcd"); devuelve 1.

• :d: establece la coincidencia con caracteres numéricos. Ejemplos:

  • match("ab:dcd","ab3cd"); devuelve 1.
  • match("ab:dcd","ab123cd"); devuelve 0.
  • match("ab:dcd","abcd"); devuelve 0.

• :n: establece la coincidencia con caracteres alfanuméricos. Ejemplos:

  • match("ab:ncd","ab%cd"); devuelve 0.
  • match("ab:ncd","ab9cd"); devuelve 1.
  • match("ab:ncd","abXcd"); devuelve 1.

• :SPACE: SPACE es el carácter de espacio (" "). Establece la coincidencia con espacios en blanco, tabulaciones y caracteres de control como Entrar (nueva línea). Ejemplos:

  • match("ab: cd","ab cd"); devuelve 1.
  • match("ab: cd","ab\ncd"); devuelve 1.
  • match("ab: cd","ab\tcd"); devuelve 1.
  • match("ab: cd","ab cd"); devuelve 0. Solo se coincide con el primer espacio.

• *: una expresión seguida de un asterisco ("*") requiere una coincidencia para cero, una o más repeticiones de la expresión anterior. Ejemplos:

  • match("abc*d","abd"); devuelve 1.
  • match("abc*d","abcd"); devuelve 1.
  • match("abc*d","abcccd"); devuelve 1.
  • match("abc*d","abxd"); devuelve 0.

• +: una expresión seguida de un signo más (+) requiere una coincidencia para una o varias apariciones de la expresión anterior. Ejemplos:

  • match("abc+d","abd"); devuelve 0.
  • match("abc+d","abcd"); devuelve 1
  • match("abc+d","abcccd"); devuelve 1.
  • match("abc+d","abxd"); devuelve 0.

• -: una expresión seguida de un signo menos (-) requiere una coincidencia para cero o una aparición de la expresión anterior. En otras palabras, la expresión anterior es opcional. Ejemplos:

  • match("colou-r","color"); devuelve 1.
  • match("colou-r","color"); devuelve 1.

• []: Coincide con un solo carácter con cualquier carácter que esté entre corchetes. Un intervalo de caracteres se puede especificar mediante dos caracteres separados por un signo menos (-). Por ejemplo, [a-z] coincide con todas las letras entre a y z, [0-9] coincide con un dígito y [0-9a-f] coincide con un dígito hexadecimal. Ejemplos:

  • match("[abc]","apple"); devuelve 1, porque coincide con el elemento en "apple".
  • match("[abc]","kiwi"); devuelve 0, porque "kiwi" no contiene un a, b o c.
  • match("gr[ae]y","grey"); devuelve 1. Esta expresión también coincide con "gris".
  • match("gr[ae]y","graey"); devuelve 0, porque solo se coincide con un carácter entre "gr" e "y".

• [^]: si el primer carácter del texto que se incluye entre corchetes es un circunflejo (^), la expresión coincide con todos los caracteres excepto los caracteres que se incluyen entre corchetes. Ejemplos:

  • match("[^bc]at","bat"); devuelve 0.
  • match("[^bc]at","hat"); devuelve 1.
  • match("[^abc]","bat"); devuelve 1. Cualquier cosa excepto a , b o c coincide. Por lo tanto, la t coincide.

strAlpha

Copia solo los caracteres alfanuméricos de una cadena.

str strAlpha(str _text)

Parámetros

Valor devuelto

Nueva cadena que contiene todos los caracteres alfanuméricos de la cadena especificada.

Observaciones

Por ejemplo, strAlpha("2+2=5 es correcto?") devuelve la cadena 225isthiscorrect.

Example

static void strAlphaExample(Args _arg)
{
    str s;
    ;
    s = strAlpha("?a*bc123.");
    print s;
    pause;
}

strCmp

Compara dos cadenas de texto.

int strCmp(str text1, str text2)

Parámetros

Valor devuelto

0 si las dos cadenas son idénticas, 1 si la primera cadena ordena anteriormente o -1 si la segunda cadena se ordena anteriormente.

Observaciones

La comparación realizada por este método distingue mayúsculas de minúsculas.

print strCmp("abc", "abc"); //Returns the value 0.
print strCmp("abc", "ABC"); //Returns the value 1.
print strCmp("aaa", "bbb"); //Returns the value -1.
print strCmp("ccc", "bbb"); //Returns the value 1.

strColSeq

Convierte todos los caracteres en mayúsculas en caracteres en minúsculas y convierte todos los caracteres que tienen acentos en los caracteres en minúsculas sincentar correspondientes.

str strColSeq(str text)

Parámetros

Valor devuelto

Cadena de texto convertida.

Observaciones

La función strColSeq existe con fines de compatibilidad con versiones anteriores. Esta función solo admite la asignación de los siguientes caracteres europeos occidentales:

• AàáâãäÀÁÂÃÄBCçÇDEèééêëÈÉÊËFGHIìíîïÌÍÎÏJKLMNñÑOòóôôõöÒÓÔÕÖPQRSTUùúùüÙÚÛÜVWXYÝZæøåÆØÅÅÅ
• aaaaaaabcccdeeeeeeeeiiiiiijklmnnooouuvwxyz~️Ç~~Ç

Para la funcionalidad compatible con Unicode, use la interfaz de programación de aplicaciones (API) lcMapString win32 a través de las clases DLL y DLLFunc .

Example

En el ejemplo siguiente se imprime abcdeabcde.

    static void strColSeqExample(Args _arg)
    {
            ;
            print strColSeq("");
            pause;
    }

strDel

Crea una copia de una cadena a partir de la cual se quita la subcadena especificada.

str strDel(str _text, int _position, int _number)

Parámetros

Valor devuelto

Los caracteres restantes que se copian de la cadena.

Observaciones

La función strDel es complementaria a la función de subcadena .

strDel("ABCDEFGH",2,3); //Returns the string "AEFGH".
strDel("ABCDEFGH",4,3); //Returns the string "ABCGH".

strFind

Busca una cadena para la primera aparición de uno de los caracteres especificados.

int strFind(str _text, str _characters, int _position, int _number)

Parámetros

Valor devuelto

Valor de la posición de la primera aparición de uno de los caracteres especificados o 0 cuando no se encuentra ninguno.

Observaciones

Para buscar desde el principio de la cadena hasta el final, use 1 como valor del parámetro _position . Si el valor del parámetro _number es negativo, el sistema busca el número de caracteres hacia atrás desde la posición especificada. La búsqueda no distingue mayúsculas de minúsculas. Este es un ejemplo.

strFind("ABCDEFGHIJ","KHD",1,10); //Returns the value 4 (the position where "D" was found).
strFind("ABCDEFGHIJ","KHD",10,-10); //Returns the value 8 (the position where "H" was found).

La función strFind es complementaria a la función strNFind .

strFmt

Da formato a la cadena especificada y sustituye las apariciones de n por el argumento n.

str strFmt(str _string, ...)

Parámetros

Valor devuelto

Cadena con formato.

Observaciones

Si no se proporciona un argumento para un parámetro, el parámetro devuelve como "%n" en la cadena. La conversión de cadenas de valores del tipo real se limita a dos posiciones decimales. Los valores se redondean, no se truncan. El método System.String::Format de Microsoft .NET Framework se puede usar para obtener más funcionalidad, como se muestra en el ejemplo.

Example

static void strFmtExampleJob(Args _arg)
{
    System.Double sysDouble;
    real r = 8.3456789;
    int  i = 42;
    utcDateTime utc = str2DateTime("2008-01-16 13:44:55" ,321); // 321 == YMD.
    str  s;
    ;
    s = strFmt("real = %1, int = %2, utcDateTime = %3, [%4]", r, i, utc);
    info("X1:  " + s);
    //
    sysDouble = r;
    s = System.String::Format("{0:##.####}", sysDouble);
    info("N1:  " + s);
    //
    s = System.String::Format("{0,6:C}", sysDouble); // $
    info("N2:  " + s);
    /**********  Actual Infolog output
    Message (02:16:05 pm)
    X1:  real = 8.35, int = 42, utcDateTime = 1/16/2008 01:44:55 pm, [%4]
    N1:  8.3457
    N2:   $8.35
    **********/
}

strIns

Crea una cadena insertando una cadena en otra.

str strIns(str _text1, str _text2, int _position)

Parámetros

Valor devuelto

Cadena de texto combinada.

Observaciones

La función strIns es complementaria a la función strDel . Si el valor del parámetro _position es mayor que la longitud de la cadena original, la cadena que se va a insertar se anexa al final de la cadena original.

strIns("ABFGH","CDE",3); //Returns the string "ABCDEFGH".
strIns("ABCD","EFGH",10); //Returns the string "ABCDEFGH".

strKeep

Crea una cadena usando solo los caracteres de la primera cadena de entrada que debe mantenerse la segunda cadena de entrada.

str strKeep(str _text1, str _text2)

Parámetros

Valor devuelto

Cadena de los caracteres que se conservan.

Observaciones

strKeep("ABBCDDEFGHB","BCD"); //Returns the string "BBCDDB".
strKeep("abcZcba","bc") //Returns the string "bccb".

La función strKeep es complementaria a la función strRem .

strLen

Calcula la longitud de la cadena especificada.

int strLen(str text)

Parámetros

Valor devuelto

Longitud de la cadena especificada.

Observaciones

strLen("ABC"); //Returns the value 3.
strLen("ABCDEFGHIJ"); //Returns the value 10.

strLine

Recupera una sola línea de una cadena que abarca varias líneas.

str strLine(str string, int count)

Parámetros

Valor devuelto

Línea copiada de la cadena especificada por el parámetro string .

Observaciones

La primera línea de la cadena tiene un desplazamiento de 0. Puede asignar varias líneas a una cadena insertando el \n o \r\n caracteres en la cadena. Además, puede usar el signo at (@) inmediatamente antes de la comilla de apertura y usar la tecla Entrar para distribuir partes del valor de cadena en varias líneas en el editor de código X++.

Example

str mytxt = "first-line\nsecond-line\nlast-line";
// Prints "second-line".
print strLine(mytxt,1);
// Prints "last-line".
print strLine(mytxt,2);            

strLTrim

Quita los espacios en blanco iniciales de una cadena de texto.

str strLTrim(str text)

Parámetros

Valor devuelto

Cadena equivalente al texto del que se han quitado los espacios en blanco iniciales.

Observaciones

La función strLTrim es complementaria a la función strRTrim .

Example

// Returns the text string "ABC-DEFG".
strLTrim("   ABC-DEFG");

strLwr

Convierte todas las letras de la cadena especificada en minúsculas.

str strLwr(str _text)

Parámetros

Valor devuelto

Copia de la cadena especificada que contiene solo letra minúscula.

Observaciones

La función strLwr es complementaria a la función strUpr . La función strLwr usa la función LCMapString en la API de Win32.

Example

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}

strNFind

Busca parte de una cadena de texto para la primera aparición de un carácter que no se incluye en la lista de caracteres especificada.

int strNFind(str _text, str _characters, int _position, int _number)

Parámetros

Valor devuelto

Posición de la primera aparición de un carácter que no se especifica en el parámetro _characters o 0 cuando no se encuentra ninguno.

Observaciones

La búsqueda no distingue mayúsculas de minúsculas. Para buscar desde el principio de la cadena hasta el final, use un valor de 1 para el parámetro _position . Si un signo menos precede al valor del parámetro _number , los caracteres se buscan en orden inverso, empezando por la posición especificada por el parámetro _position .

strNFind("ABCDEFGHIJ","ABCDHIJ",1,10); //Returns the value 5 (the position of "E");
strNFind("CDEFGHIJ","CDEFGIJ",10,-10); //Returns the value 6 (the position of "H").
strNFind("abcdef","abCdef",3,2) //Returns the value 0.
strNFind("abcdef", "abcef",3,2) //Returns the value 4.

La función strNFind es complementaria a la función strFind .

strPoke

Sobrescribe parte de una cadena con otra cadena.

str strPoke(str _text1, str _text2, int _position)

Parámetros

Valor devuelto

Nueva cadena.

Observaciones

La nueva cadena puede ser mayor que la cadena original. Sin embargo, si el valor del parámetro _position es mayor que la longitud de la cadena, la cadena original se devuelve sin reemplazos.

strPoke("12345678","AAA",3); //Returns the string "12AAA678".
strPoke("abcde","4567",4); //Returns the string "abc4567".
strPoke("abcde", "4567", "10"); //Returns the string "abcde".

strPrompt

Anexa una cadena con el número especificado de caracteres de punto, seguido de dos puntos y un carácter de espacio.

str strPrompt(str _string, _int len)

Parámetros

Valor devuelto

Cadena que parece una solicitud de entrada del usuario.

Observaciones

En casos atípicos, donde el valor del parámetro _len es ligeramente mayor que la longitud de la cadena original, se da la prioridad más alta para agregar el espacio final. A continuación, se da prioridad a los dos puntos. La prioridad más baja se da a los períodos. Los valores negativos del parámetro _len devuelven la cadena de entrada anexada con un espacio final.

strPrompt("ab",-1); //Returns "ab ".
strPrompt("ab",3); //Returns "ab ".
strPrompt("ab",4); //Returns "ab: ".
strPrompt("ab",5); //Returns "ab.: ".
strPrompt("ab",6); //Returns "ab..: ".

Example

static void JobStrPromptDemo(Args _args)
{
    // Printed string is "[abc..: ]"
    print "[", strPrompt("abc", 7), "]";
    pause;
}

strRem

Quita los caracteres especificados en una cadena de otra cadena.

str strRem(str text1, str text2)

Parámetros

Valor devuelto

El contenido restante de la cadena original.

Observaciones

Esta función distingue mayúsculas de minúsculas.

strRem("abcd_abcd","Bc"); //Returns the string "abd_abd".
strRem("ABCDEFGABCDEFG","ACEG"); //Returns the string "BDFBDF".

Esta función es complementaria a la función strKeep .

strRep

Repite una cadena de caracteres.

str strRep(str _text, str _number)

Parámetros

Valor devuelto

Nueva cadena que contiene el contenido de la cadena original que se repite el número de veces especificado.

Example

En el ejemplo siguiente se imprime la cadena de texto ABABABABABAB.

static void strRepExample(Args _arg)
{
    str strL;
    ;
    strL = strRep("AB",6);
    print strL;
    pause;
}

strRTrim

Quita los caracteres de espacio final del final de una cadena.

str strRTrim(str _text)

Parámetros

Valor devuelto

Copia de la cadena especificada que no incluye caracteres de espacio final.

Observaciones

strRTrim("ABC-DEFG- "); //Returns the string "ABC-DEFG-".
strRTrim(" CD "); //Returns " CD".

La función strRTrim es complementaria a la función strLTrim .

strScan

Busca en una cadena de texto una aparición de otra cadena.

int strScan(str _text1, str _text2, int _position, int _number)

Parámetros

Valor devuelto

Posición en la que se encontró la cadena especificada en la cadena; de lo contrario, 0 (cero).

Observaciones

Las comparaciones no distinguen mayúsculas de minúsculas. Los valores del parámetro _position que son inferiores a 1 se tratan como 1. La dirección del examen se controla mediante el signo especificado en el parámetro _number . Un signo positivo indica que cada comparación sucesiva inicia una posición más cercana al final de la cadena. Un signo negativo indica que cada comparación comienza una posición más cercana al inicio de la cadena.

strScan("ABCDEFGHIJ","DEF",1,10); //Returns the value 4.
strScan ("ABCDEFGHIJ","CDE",10,-10); //Returns the value 3.

strUpr

Convierte todas las letras de una cadena en mayúsculas.

str strUpr(str _text)

Parámetros

Valor devuelto

Copia de la cadena especificada que contiene solo letras minúsculas.

Observaciones

La función strUpr es complementaria a la función strLwr . La función strUpr usa la función LCMapString() en la API de Win32.

Example

En el ejemplo siguiente se imprime ABCDD55EFGHIJ.

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

subStr

Recupera parte de una cadena.

str subStr(str _text, int _position, int _number)

Parámetros

Valor devuelto

Subcadena de la cadena original.

Observaciones

Si un signo menos precede al valor del parámetro _number , la subcadena se selecciona hacia atrás desde la posición especificada.

subStr("ABCDEFGHIJ",3,5); //Returns the string "CDEFG".
subStr("ABCDEFGHIJ",7,-4); //Returns the string "DEFG".
subStr("abcdef",2,99) //Returns the string "bcdef".
subStr("abcdef",2,3) //Returns the string "bcd".
subStr("abcdef",2,-3); //Returns the string "ab".

strContains

Comprueba si la cadena de texto contiene otra cadena.

boolean strContains(str _text, str _potentialContains)

Parámetros

Valor devuelto

True si la cadena original contiene la cadena buscada; de lo contrario, false.

Observaciones

Las comparaciones no distinguen mayúsculas de minúsculas.

strContains("ABCDEFGHIJ","abc"); //Returns true.
strContains("ABCDEFGHIJ","ABC"); //Returns true.
strContains("ABCDEFGHIJ","K"); //Returns false.

strStartsWith

Comprueba si la cadena de texto comienza con otra cadena.

boolean strStartsWith(str _string, str _potentialStart)

Parámetros

Valor devuelto

True si la cadena potencial es el principio de la cadena original; de lo contrario, false.

Observaciones

Las comparaciones no distinguen mayúsculas de minúsculas.

strStartsWith("ABCDEFGHIJ","abc"); //Returns true.
strStartsWith("ABCDEFGHIJ","ABC"); //Returns true.
strStartsWith("ABCDEFGHIJ","B"); //Returns false.

strEndsWith

Comprueba si la cadena de texto termina con otra cadena.

boolean strEndsWith(str _string, str _potentialEnd)

Parámetros

Valor devuelto

True si la cadena potencial finaliza la cadena original; de lo contrario, false.

Observaciones

Las comparaciones no distinguen mayúsculas de minúsculas.

strEndsWith("ABCDEFGHIJ","ghij"); //Returns true.
strEndsWith("ABCDEFGHIJ","HIJ"); //Returns true.
strEndsWith("ABCDEFGHIJ","B"); //Returns false.

strLRTrim

Quita los espacios en blanco iniciales y finales de una cadena de texto.

str strLRTrim(str text)

Parámetros

Valor devuelto

Copia de la cadena especificada que no incluye caracteres de espacio inicial y final.

Observaciones

La función strLRTrim es complementaria a las funciones strRTrim y strLTrim .

Example

// Returns the text string "ABC-DEFG".
strLRTrim("   ABC-DEFG   ");