# Funções de tabela

As funções de tabela retornam informações sobre a tabela de dados que está sendo lida no momento. Se nenhum nome de tabela for especificado e a função for usada em um comando LOAD, a tabela atual será usada.

Todas as funções podem ser usadas no script de carregamento, enquanto que apenas NoOfRows pode ser usada em uma expressão do gráfico.

Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Para algumas das funções, você pode obter mais detalhes clicando no nome da função na descrição da sintaxe.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### FieldName

Essa FieldName função de script retorna o nome do campo com o número especificado dentro de uma tabela previamente carregada. Se a função for utilizada em um comando LOAD, ela não deverá fazer referência à tabela que estiver sendo carregada no momento.

[**FieldName**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/FieldName.htm)(field\_number ,table\_name)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### FieldNumber

Essa FieldNumber função de script retorna o número de um campo especificado em uma tabela previamente carregada. Se a função for utilizada em um comando LOAD, ela não deverá fazer referência à tabela que estiver sendo carregada no momento.

[**FieldNumber**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/FieldNumber.htm)(field\_name ,table\_name)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### NoOfFields

Essa NoOfFields função de script retorna o número de campos em uma tabela previamente carregada. Se a função for utilizada em um comando LOAD, ela não deverá fazer referência à tabela que estiver sendo carregada no momento.

[**NoOfFields**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/NoOfFields.htm)(table\_name)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### NoOfRows

A função NoOfRows retorna o número de linhas (registros) em uma tabela anteriormente carregada. Se a função for utilizada em um comando LOAD, ela não deverá fazer referência à tabela que estiver sendo carregada no momento.

[**NoOfRows**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/NoOfRows.htm)(table\_name)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### NoOfTables

Essa função de script retorna o número de tabelas carregadas anteriormente.

NoOfTables()

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### TableName

Essa função de script retorna o nome da tabela com o número especificado.

TableName(table\_number)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/TableFunctions/table-functions.htm)

#### TableNumber

Essa função de script retorna o número da tabela especificada. A primeira tabela tem o número 0.

Se table\_name não existir, nenhum valor será retornado. Se uma função estiver definida para retornar um valor funcional, essa variável não será inicializada. Como solução alternativa, você pode especificar `LET vImaginaryTabNum = If(TableNumber('NotExistingTable')>=0,TableNumber('NotExistingTable'),'NULL') ;`

TableNumber(table\_name)

Exemplo:

Neste exemplo, queremos criar uma tabela com informações sobre as tabelas e campos que foram carregados.

Primeiro, carregamos alguns dados de amostra. Isso cria as duas tabelas que serão utilizadas para ilustrar as funções de tabela descritas nesta seção.

```
Characters: Load Chr(RecNo()+Ord('A')-1) as Alpha, RecNo() as Num autogenerate 26;  ASCII: Load   if(RecNo()>=65 and RecNo()<=90,RecNo()-64) as Num,  Chr(RecNo()) as AsciiAlpha,   RecNo() as AsciiNum autogenerate 255  Where (RecNo()>=32 and RecNo()<=126) or RecNo()>=160 ;
```

```
 
```

Em seguida, vamos reiterar as tabelas que foram carregadas, usando a função NoOfTables, e, em seguida, através dos campos de cada tabela, utilizando a função NoOfFields, e carregamos as informações usando as funções da tabela.

```
//Iterate through the loaded tables For t = 0 to NoOfTables() - 1  //Iterate through the fields of table  For f = 1 to NoOfFields(TableName($(t)))   Tables:   Load     TableName($(t)) as Table,    TableNumber(TableName($(t))) as TableNo,    NoOfRows(TableName($(t))) as TableRows,    FieldName($(f),TableName($(t))) as Field,     FieldNumber(FieldName($(f),TableName($(t))),TableName($(t))) as FieldNo    Autogenerate 1;  Next f Next t;
```

A tabela resultante Tables ficará assim:

Tables table

| Table | TableNo | TableRows | Field | FieldNo |
| --- | --- | --- | --- | --- |
| Characters | 0 | 26 | Alpha | 1 |
| Characters | 0 | 26 | Num | 2 |
| ASCII | 1 | 191 | Num | 1 |
| ASCII | 1 | 191 | AsciiAlpha | 2 |
| ASCII | 1 | 191 | AsciiNum | 3 |