Funções X++ de tempo de execução de cadeia

Este artigo descreve as funções de tempo de execução da cadeia de caracteres.

Jogo

Procura uma cadeia de caracteres ou expressão em outra cadeia de caracteres.

int match(str pattern, str text)

Parâmetros

Valor de retorno

1 se o padrão estiver localizado na corda; caso contrário, 0 (zero).

Observações

A pesquisa não diferencia maiúsculas de minúsculas. Os seguintes caracteres especiais podem ser usados para criar o padrão para o parâmetro pattern .

• \: Uma barra invertida (\) anula, ou escapa, o tratamento especial de caracteres especiais, de modo que um caractere especial pode ser correspondido como uma letra normal. Um par de barras invertidas é traduzido em uma barra invertida não especial. Examples:

  • match("ab$cd","ab$cd"); retorna 0.
  • match("ab\$cd","ab$cd"); retorna 0. O backslash não escapa.
  • match("ab\\$cd","ab$cd"); devoluções 1. O backslash e o cifrão escapam.

• < ou ^: Um colchete angular esquerdo (<) ou um circunflexo (^) no início de uma expressão é usado para corresponder ao início de uma linha. Examples:

  • match("<abc","abcdef"); retorna 1.
  • match("<abc","defabc"); retorna 0.
  • match("^abc","abcdef"); devoluções 1.
  • match("^abc","defabc"); retorna 0.

• > ou $: Um colchete angular reto (>) ou um cifrão ($) no final da expressão é usado para corresponder ao final de uma linha. Examples:

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

• ? ou .: Um ponto de interrogação (?) ou um ponto (.) corresponde a qualquer caractere na mesma posição. Examples:

  • match("abc.def","abc#def"); devoluções 1.
  • match("colou?r","colouXr"); devoluções 1.

• :x: Dois pontos (:) especifica um grupo de caracteres a serem correspondidos, conforme indicado pelo caractere imediatamente a seguir.

• :a: Define a correspondência como letras. Examples:

  • match("ab:acd","ab#cd"); retorna 0.
  • match("ab:acd","abxyzcd"); retorna 0.
  • match("ab:acd","abxcd"); devoluções 1.

• :d: Define a correspondência como caracteres numéricos. Examples:

  • correspondência("ab:dcd","ab3cd"); devoluções 1.
  • correspondência("ab:dcd","ab123cd"); retorna 0.
  • correspondência("ab:dcd","abcd"); retorna 0.

• :n: Define a correspondência como caracteres alfanuméricos. Examples:

  • match("ab:ncd","ab%cd"); retorna 0.
  • correspondência("ab:ncd","ab9cd"); devoluções 1.
  • correspondência("ab:ncd","abXcd"); devoluções 1.

• :SPACE: SPACE é o caractere espacial (" "). Define a correspondência como espaços em branco, tabulações e caracteres de controle, como Enter (nova linha). Examples:

  • correspondência("ab: cd","ab cd"); devoluções 1.
  • correspondência("ab: cd","ab\ncd"); devoluções 1.
  • correspondência("ab: cd","ab\tcd"); devoluções 1.
  • correspondência("ab: cd","ab cd"); retorna 0. Apenas o primeiro espaço é correspondido.

• *: Uma expressão seguida por um asterisco ("*") requer uma correspondência para zero, uma ou mais ocorrências da expressão anterior. Examples:

  • match("abc*d","abd"); devoluções 1.
  • match("abc*d","abcd"); devoluções 1.
  • match("abc*d","abcccd"); devoluções 1.
  • match("abc*d","abxd"); retorna 0.

• +: Uma expressão seguida por um sinal de adição (+) requer uma correspondência para uma ou mais ocorrências da expressão anterior. Examples:

  • match("abc+d","abd"); retorna 0.
  • match("abc+d","abcd"); devoluções 1
  • match("abc+d","abcccd"); devoluções 1.
  • match("abc+d","abxd"); retorna 0.

• -: Uma expressão seguida por um sinal de subtração (-) requer uma correspondência para zero ou uma ocorrência da expressão anterior. Por outras palavras, a expressão anterior é opcional. Examples:

  • match("colou-r","cor"); devoluções 1.
  • match("colou-r","cor"); devoluções 1.

• []: Corresponde a um único caractere com qualquer caractere entre colchetes. Um intervalo de caracteres pode ser especificado por dois caracteres separados por um sinal de subtração (-). Por exemplo, [a-z] corresponde a todas as letras entre a e z, [0-9] corresponde a um dígito e [0-9a-f] corresponde a um dígito hexadecimal. Examples:

  • match("[abc]","maçã"); retorna 1, porque corresponde ao a em "maçã".
  • match("[abc]","kiwi"); retorna 0, porque "kiwi" não contém um a, b ou c.
  • match("gr[ae]y","cinzento"); devoluções 1. Esta expressão também corresponde a "cinza".
  • match("gr[ae]y","graey"); retorna 0, porque apenas um caractere entre "gr" e "y" é correspondido.

• [^]: Se o primeiro caractere do texto entre colchetes for um circunflexo (^), a expressão corresponder a todos os caracteres, exceto os caracteres entre colchetes. Examples:

  • match("[^bc]at","morcego"); retorna 0.
  • match("[^bc]at","chapéu"); devoluções 1.
  • match("[^abc]","morcego"); devoluções 1. Qualquer coisa, exceto a, b ou c, é correspondida. Portanto, o t é correspondido.

strAlpha

Copia apenas os caracteres alfanuméricos de uma cadeia de caracteres.

str strAlpha(str _text)

Parâmetros

Valor de retorno

Uma nova cadeia de caracteres que contém todos os caracteres alfanuméricos da cadeia de caracteres especificada.

Observações

Por exemplo, strAlpha("2+2=5 está correto?") retorna a string 225isthiscorrect.

Example

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

strCmp

Compara duas cadeias de texto.

int strCmp(str text1, str text2)

Parâmetros

Valor de retorno

0 se as duas cadeias de caracteres forem idênticas, 1 se a primeira cadeia classificar mais cedo ou -1 se a segunda cadeia classificar anteriormente.

Observações

A comparação realizada por este método diferencia maiú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

Converte todos os caracteres maiúsculos em minúsculos e converte todos os caracteres com acentos nos caracteres minúsculos não acentuados correspondentes.

str strColSeq(str text)

Parâmetros

Valor de retorno

A cadeia de texto convertida.

Observações

A função strColSeq existe para fins de compatibilidade com versões anteriores. Esta função suporta apenas o mapeamento para os seguintes caracteres da Europa Ocidental:

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

Para funcionalidade compatível com Unicode, use a interface de programação de aplicativo (API) Win32 LCMapString por meio das classes DLL e DLLFunc .

Example

O exemplo a seguir imprime abcdeabcde.

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

strDel

Cria uma cópia de uma cadeia de caracteres, da qual a substring especificada é removida.

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

Parâmetros

Valor de retorno

Os caracteres restantes que são copiados da cadeia de caracteres.

Observações

A função strDel é complementar à função substr .

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

strEncontrar

Pesquisa uma cadeia de caracteres para a primeira ocorrência de um dos caracteres especificados.

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

Parâmetros

Valor de retorno

O valor da posição da primeira ocorrência de um dos caracteres especificados, ou 0 quando nenhum encontrado.

Observações

Para pesquisar do início da cadeia de caracteres até o final, use 1 como o valor do parâmetro _position . Se o valor do parâmetro _number for negativo, o sistema pesquisará o número de caracteres para trás a partir da posição especificada. A pesquisa não é sensível a maiúsculas e minúsculas. Eis um exemplo.

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).

A função strFind é complementar à função strNFind .

strFmt

Formata a cadeia de caracteres especificada e substitui quaisquer ocorrências de n pelo nono argumento.

str strFmt(str _string, ...)

Parâmetros

Valor de retorno

A cadeia de caracteres formatada.

Observações

Se um argumento não for fornecido para um parâmetro, o parâmetro retornará como "%n" na cadeia de caracteres. A conversão de cadeia de valores do tipo real é limitada a duas casas decimais. Os valores são arredondados, não truncados. O método System.String::Format do Microsoft .NET Framework pode ser usado para obter mais funcionalidade, conforme mostrado no exemplo.

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
    **********/
}

Vertentes

Cria uma cadeia de caracteres inserindo uma cadeia de caracteres em outra.

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

Parâmetros

Valor de retorno

A cadeia de caracteres de texto combinada.

Observações

A função strIns é complementar à função strDel . Se o valor do parâmetro _position for maior do que o comprimento da cadeia de caracteres original, a cadeia de caracteres a ser inserida será acrescentada ao final da cadeia de caracteres original.

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

strKeep [en]

Cria uma cadeia de caracteres usando apenas os caracteres da primeira cadeia de caracteres de entrada que a segunda cadeia de caracteres de entrada especifica que devem ser mantidos.

str strKeep(str _text1, str _text2)

Parâmetros

Valor de retorno

Uma cadeia de caracteres que são mantidos.

Observações

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

A função strKeep é complementar à função strRem .

strLen

Calcula o comprimento da cadeia de caracteres especificada.

int strLen(str text)

Parâmetros

Valor de retorno

O comprimento da cadeia de caracteres especificada.

Observações

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

strLine

Recupera uma única linha de uma cadeia de caracteres que abrange várias linhas.

str strLine(str string, int count)

Parâmetros

Valor de retorno

Uma linha copiada da cadeia de caracteres especificada pelo parâmetro string .

Observações

A primeira linha da cadeia de caracteres tem um deslocamento de 0. Você pode atribuir várias linhas a uma cadeia de caracteres incorporando os \n ou \r\n caracteres na cadeia de caracteres. Além disso, você pode usar o sinal de arroba (@) imediatamente antes das aspas de abertura e usar a tecla Enter para espalhar partes do valor da cadeia de caracteres em várias linhas no 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

Remove espaços em branco à esquerda de uma cadeia de texto.

str strLTrim(str text)

Parâmetros

Valor de retorno

O equivalente de cadeia de caracteres para o texto do qual os espaços em branco à esquerda foram removidos.

Observações

A função strLTrim é complementar à função strRTrim .

Example

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

strLwr

Converte todas as letras na cadeia de caracteres especificada em minúsculas.

str strLwr(str _text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que contém apenas letras minúsculas.

Observações

A função strLwr é complementar à função strUpr . A função strLwr usa a função LCMapString na API do Win32.

Example

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

strNFind

Pesquisa parte de uma cadeia de caracteres de texto para a primeira ocorrência de um caractere que não está incluído na lista especificada de caracteres.

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

Parâmetros

Valor de retorno

A posição da primeira ocorrência de um caractere que não é especificado pelo parâmetro _characters ou 0 quando nenhum encontrado.

Observações

A pesquisa não é sensível a maiúsculas e minúsculas. Para pesquisar do início da cadeia de caracteres até o final, use um valor de 1 para o parâmetro _position . Se um sinal de menos precede o valor do parâmetro _number , os caracteres são pesquisados em ordem inversa, a partir da posição especificada pelo 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.

A função strNFind é complementar à função strFind .

strPoke

Substitui parte de uma cadeia de caracteres por outra cadeia de caracteres.

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

Parâmetros

Valor de retorno

A nova cadeia de caracteres.

Observações

A nova cadeia de caracteres pode ser maior do que a cadeia de caracteres original. No entanto, se o valor do parâmetro _position for maior do que o comprimento da cadeia de caracteres, a cadeia de caracteres original será retornada sem substituições.

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 [en]

Acrescenta uma cadeia de caracteres com o número especificado de caracteres de período, seguido por dois pontos e um caractere de espaço.

str strPrompt(str _string, _int len)

Parâmetros

Valor de retorno

Uma cadeia de caracteres que se parece com um prompt para entrada do usuário.

Observações

Em casos atípicos, onde o valor do parâmetro _len é apenas um pouco maior do que o comprimento da cadeia de caracteres original, a maior precedência é dada à adição do espaço à direita. Em seguida, é dada precedência aos dois pontos. A menor precedência é dada aos períodos. Valores negativos para o parâmetro _len retornam a cadeia de caracteres de entrada acrescentada com um espaço à direita.

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

Remove os caracteres especificados em uma cadeia de caracteres de outra cadeia de caracteres.

str strRem(str text1, str text2)

Parâmetros

Valor de retorno

O conteúdo restante da cadeia de caracteres original.

Observações

Esta função diferencia maiúsculas de minúsculas.

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

Esta função é complementar à função strKeep .

strRep

Repete uma cadeia de caracteres.

str strRep(str _text, str _number)

Parâmetros

Valor de retorno

Uma nova cadeia de caracteres que contém o conteúdo da cadeia de caracteres original que é repetida o número especificado de vezes.

Example

O exemplo a seguir imprime a cadeia de caracteres de texto ABABABABABAB.

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

strRTrim

Remove os caracteres de espaço à direita do final de uma cadeia de caracteres.

str strRTrim(str _text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que não inclui caracteres de espaço à direita.

Observações

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

A função strRTrim é complementar à função strLTrim .

strScan [en]

Pesquisa uma cadeia de caracteres de texto para uma ocorrência de outra cadeia de caracteres.

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

Parâmetros

Valor de retorno

A posição na qual a string especificada foi encontrada na string; caso contrário, 0 (zero).

Observações

As comparações não diferenciam maiúsculas de minúsculas. Os valores para o parâmetro _position inferiores a 1 são tratados como 1. A direção da verificação é controlada pelo sinal especificado no parâmetro _number . Um sinal positivo indica que cada comparação sucessiva inicia uma posição mais próxima do final da cadeia de caracteres. Um sinal negativo indica que cada comparação inicia uma posição mais próxima do início da cadeia de caracteres.

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

strUpr

Converte todas as letras de uma cadeia de caracteres em maiúsculas.

str strUpr(str _text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que contém apenas letras minúsculas.

Observações

A função strUpr é complementar à função strLwr . A função strUpr usa a função LCMapString() na API do Win32.

Example

O exemplo a seguir imprime ABCDD55EFGHIJ.

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

subStr

Recupera parte de uma cadeia de caracteres.

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

Parâmetros

Valor de retorno

Uma substring da cadeia de caracteres original.

Observações

Se um sinal de subtração preceder o valor do parâmetro _number , a substring será selecionada para trás a partir da posição 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".

strContém

Verifica se a cadeia de texto contém outra cadeia de caracteres.

boolean strContains(str _text, str _potentialContains)

Parâmetros

Valor de retorno

True se a cadeia de caracteres original contiver a cadeia de caracteres pesquisada; caso contrário, false.

Observações

As comparações não diferenciam maiúsculas de minúsculas.

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

strStartsCom

Verifica se a cadeia de texto começa com outra cadeia de caracteres.

boolean strStartsWith(str _string, str _potentialStart)

Parâmetros

Valor de retorno

True se a cadeia de caracteres potencial for o início da cadeia de caracteres original; caso contrário, false.

Observações

As comparações não diferenciam maiúsculas de minúsculas.

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

strEndsCom

Verifica se a cadeia de texto termina com outra cadeia de caracteres.

boolean strEndsWith(str _string, str _potentialEnd)

Parâmetros

Valor de retorno

True se a cadeia de caracteres potencial estiver terminando a cadeia de caracteres original; caso contrário, false.

Observações

As comparações não diferenciam maiúsculas de minúsculas.

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

strLRTrim

Remove espaços em branco à esquerda e finais de uma cadeia de texto.

str strLRTrim(str text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que não inclui caracteres de espaço à esquerda e à direita.

Observações

A função strLRTrim é complementar às funções strRTrim e strLTrim .

Example

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