Saltar para o conteúdo principal
Versão: Próximo

STRING LIST TO ARRAY

STRING LIST TO ARRAY ( resNum ; cadeias {; resArquivo} )

ParâmetroTipoDescrição
resNumIntegerNº do recurso ou atributo "id" do elemento "group" (XLIFF)
cadeiasText arrayStrings do recurso STR# ou strings do elemento "group"(XLIFF)
resArquivoTimeArquivo de número de referencia de Resource se omitido: todos os arquivos XLIFF ou arquivos de resources abertos

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comando STRING LIST TO ARRAY preenche o array cadeias com:

  • As cadeias armazenadas no recurso de tipo lista de cadeias ("STR#") cujo número se passa em resNum.
  • Ou com una cadeia armazenada em um arquivo XLIFF aberto cujo atributo "id" do elemento "group" se passa em resNum (ver a continuação "Compatibilidade com arquitetura XLIFF"). Se o recurso não for encontrado, o array cadeias não muda e a variável OK assume o valor 0 (zero).

Se passa um número de referência de arquivo de recursos válido em resArquivo, o recurso é pesquisado apenas nesse arquivo. Se não passa resArquivo, se devolverá a primeira ocorrência do recurso encontrado na fila de arquivos de recursos. Antes de chamar STRING LIST TO ARRAY, pode pré-declarar o array cadeias como una array de tipo cadeia ou texto. Se não pré-declara o array, o comando cria cadeias como um array de tipo Texto.

Nota: Cada cadeia de um recurso lista de cadeias pode conter até 255 caracteres.

Dica: Quando utilize os recursos listas de cadeias, limite-se a recursos de 32K, e a um máximo de umas centenas de cadeias por recurso.

Compatibilidade com arquitetura XLIFF

O comando STRING LIST TO ARRAY é compatível com a arquitetura XLIFF de 4D a partir da versão 11: o comando busca primeiro pelos valores correspondentes a resNum e cadeiaNum em todos os arquivos XLIFF abertos (se o parâmetro resArquivo for omitido) e preenche o array cadeias com os valores correspondentes. Neste caso, resNum específica o atributo id do elemento group e o array cadeias contém todas as cadeias do elemento. Se não for encontrado o valor, o comando continua a pesquisa nos arquivos de recursos abertos. Para maior informação sobre a arquitetura XLIFF em 4D, consulte o Manual de Desenho.

Variáveis e conjuntos do sistema

Se o recurso for encontrado, a variável sistema OK assume o valor 1, do contrário assume o valor 0 (zero).

Ver também

Get indexed string
Get string resource
Get text resource