PHP Classes

File: doc/xml/store.xml

Recommend this page to a friend!
  Classes of Everton da Rosa   XtPHP   doc/xml/store.xml   Download  
File: doc/xml/store.xml
Role: Auxiliary data
Content type: text/plain
Description: Auxiliary data
Class: XtPHP
General purpose library of utility classes
Author: By
Last change:
Date: 9 years ago
Size: 16,867 bytes
 

Contents

Class file image Download
<?xml version="1.0"?> <document title="XtPHP" description="Biblioteca de classes que facilitam a vida do programador."> <class name="XtStore"> <description>XtStore é uma classe do XtPHP que facilita a manipulação de matrizes de dados. XtStore se baseia em STORES, que é um array multidimensional onde a primeira dimensão se refere às linhas e as segundas dimensões são cada conjunto de colunas de cada linha, com o nome dos campos e os dados armazenados.</description> <methods> <method name="sort" visibility="public" example="store_sort.php"> <description>Ordena o store com base na ordem passada em $order. Atualmente suporta ordenação para até cinco campos do store.</description> <params> <param type="array" name="$store" optional="false" default="">Um Store com os dados para ordenar.</param> <param type="array" name="$order" optional="false" default="">Um array com a opção de ordenação, no seguinte formato: nomedocampo => ordem. A ordenação pode ser ASC (ascendente) ou DESC (descendente).</param> </params> <return type="array">Retorna o Store ordenado.</return> </method> <method name="find" visibility="public" example="store_find.php"> <description>Procura por um valor em um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store fonte da busca.</param> <param type="string" name="$search" optional="false" default="">O valor a ser procurado.</param> <param type="array" name="$fields" optional="true" default="false">Um array com os nomes dos campos do Store que serão alvo da busca. Se nada for especificado, a busca será realizada em todos os campos do Store.</param> </params> <return type="array">Retorna um novo Store somente com as linhas que correspondem à string de procura.</return> </method> <method name="fields" visibility="public" example="store_fields.php"> <description>Retorna os nomes dos campos de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> </params> <return type="array">Retorna um array com os nomes de campos.</return> </method> <method name="page" visibility="public" example="store_page.php"> <description>Método para paginar um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store a ser paginado.</param> <param type="int" name="$page" optional="true" default="1">O número da página a ser retornada.</param> <param type="int" name="$size" optional="true" default="10">O tamanho da página (quantos registros a página terá).</param> </params> <return type="array">Retorna um Store contendo uma página do Store passado por $store.</return> </method> <method name="pages" visibility="public" example="store_page.php"> <description>Retorna o total de páginas de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> <param type="int" name="$size" optional="true" default="10">O tamanho da página (quantos registros a página terá).</param> </params> <return type="integer">Retorna o número de páginas do Store.</return> </method> <method name="fromMysql" visibility="public" example="store_frommysql.php"> <description>Converte um resultado de uma busca Mysql em um Store.</description> <params> <param type="resource" name="$result" optional="false" default="">O resource de resultado Mysql.</param> </params> <return type="array">Retorna um Store contendo os dados da busca Mysql.</return> </method> <method name="addRow" visibility="public" example="store_addrow.php"> <description>Adiciona uma linha a um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store que receberá a nova linha.</param> <param type="array" name="$row" optional="false" default="">A linha a ser adicionada. Deve ter um formato de Store com uma única linha.</param> <param type="mixed" name="$ref" optional="true" default="last">A posição em que a linha será adicionada. "first" para adicionar no início e "last" para adicionar ao final, ou um número para adicionar em posição diferente.</param> </params> <return type="array">Retorna um Store com a nova linha.</return> </method> <method name="delRow" visibility="public" example="store_delrow.php"> <description>Exclui uma linha de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store que terá a linha excluída.</param> <param type="integer" name="$index" optional="false" default="">A linha a ser excluída.</param> <param type="bool" name="$reindex" optional="true" default="true">True para recalcular os números de linha e false para deixar os números de linha originais.</param> </params> <return type="array">Retorna um Store com a nova linha.</return> </method> <method name="addCol" visibility="public" example="store_addcol.php"> <description>Adiciona uma coluna a um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store que receberá a nova coluna.</param> <param type="array" name="$col" optional="false" default="">A coluna a ser adicionada. Deve ter um formato de Store com uma única coluna e com a mesma quantidade de linhas do Store principal.</param> <param type="string" name="$name" optional="false" default="">Nome da coluna a ser adicionada.</param> <param type="mixed" name="$ref" optional="true" default="last">A posição em que a coluna será adicionada. "first" para adicionar no início e "last" para adicionar ao final, ou um número para adicionar em posição diferente.</param> </params> <return type="array">Retorna um Store com a nova coluna.</return> </method> <method name="delCol" visibility="public" example="store_delcol.php"> <description>Remove uma coluna a um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store que terá coluna excluída.</param> <param type="string" name="$col" optional="false" default="">Nome da coluna a ser excluída.</param> </params> <return type="array">Retorna um Store sem a coluna excluída.</return> </method> <method name="orderCols" visibility="public" example="store_ordercol.php"> <description>Ordena colunas de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store a ser ordenado.</param> <param type="array" name="$order" optional="false" default="">Um array com os nomes de colunas na ordem desejada.</param> </params> <return type="array">Retorna um Store com as colunas ordenadas.</return> </method> <method name="applyFn" visibility="public" example="store_applyfn.php"> <description>Aplica uma função em uma coluna de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> <param type="string" name="$fn" optional="false" default="">O nome da função (sem "()"). A função deve receber como parâmetro uma linha inteira por vez, executar o tratamento dos dados desejados e retornar o valor para o campo especificado em $field.</param> <param type="string" name="$field" optional="false" default="">Nome da coluna a qual a função será aplicada.</param> </params> <return type="array">Retorna um Store.</return> </method> <method name="fromCSV" visibility="public" example="store_fromcsv.php"> <description>Lê o conteúdo de um arquivo do tipo CSV (campos separados por vírgula ou ponto-e-vírgula) e converte em um Store.</description> <params> <param type="string" name="$file" optional="false" default="">O caminho completo para o arquivo. Lembre-se que o PHP deve ter permissão de leitura desse arquivo.</param> <param type="array" name="$fields" optional="false" default="">Um array contendo o nome dos campos.</param> <param type="string" name="$separator" optional="true" default=";">O separador de coluna.</param> <param type="string" name="$enclosure" optional="true" default="aspas">O caractere qualificador de texto. O padrão é "" (aspas). Caso deseje especificar outro, lembre-se que apenas úm é necessário (no caso, apenas ").</param> <param type="string" name="$escape" optional="true" default="/">O caractere de escape para caracteres especiais.</param> </params> <return type="array">Retorna um Store com os dados do arquivo.</return> </method> <method name="toCSV" visibility="public" example="store_tocsv.php"> <description>Converte um Store em um arquivo CSV.</description> <params> <param type="array" name="$store" optional="false" default="">O Store a ser convertido.</param> <param type="mixed" name="$fields" optional="true" default="true">True para colocar os nomes dos campos do Store na primeira linha, False para não colocar nomes de campos ou um array contendo os nomes de cmapos desejados.</param> <param type="string" name="$separator" optional="true" default=";">O separador de coluna.</param> <param type="string" name="$enclosure" optional="true" default="aspas">O caractere qualificador de texto. O padrão é "" (aspas). Caso deseje especificar outro, lembre-se que apenas úm é necessário (no caso, apenas ").</param> </params> <return type="array">Retorna um array onde cada elemento corresponde a uma linha do arquivo CSV.</return> </method> <method name="fromFixed" visibility="public" example="store_fromfixed.php"> <description>Lê o conteúdo de um arquivo de texto (campos com largura fixa ou equivalente) e converte em um Store.</description> <params> <param type="string" name="$file" optional="false" default="">O caminho completo para o arquivo. Lembre-se que o PHP deve ter permissão de leitura desse arquivo.</param> <param type="array" name="$cm" optional="false" default="">O layout das colunas na forma de um array com as seguintes chaves para cada coluna: title (título da coluna), start (caractere de início da coluna), size (tamanho em caracteres da coluna), fn (nome de uma função a ser aplicada). Sobre fn, a função deve receber a linha inteira do Store e retornar um valor para ser armazenado no campo.</param> <param type="mixed" name="$filter" optional="true" default="0">Determina se cada linha do arquivo será validada. Se 0, não será feita validação. Se for um inteiro, cada linha será aceita se o seu tamanho corresponder ao número passado. Se for string, corresponde ao nome de uma função que recebe a linha do arquivo e retorna true ou false se validada ou não. Cada linha, quando testada, somente será convertida se for validada.</param> <param type="integer" name="$firstRow" optional="true" default="0">O número da linha pela qual se iniciará a importação.</param> </params> <return type="array">Retorna um Store com os dados do arquivo.</return> </method> <method name="toSQL" visibility="public" example="store_tosql.php"> <description>Converte um Store em string INSERT para Mysql.</description> <params> <param type="array" name="$store" optional="false" default="">O Store a ser convertido.</param> <param type="string" name="$table" optional="false" default="">O nome da tabela a ser utilizada.</param> <param type="mixed" name="$fields" optional="true" default="true">Se true, utiliza o nome dos campos do Store como nome de campos do Mysql. Senão, recebe um array com os nomes de cmapos a serem utilizados.</param> <param type="boolean" name="$create" optional="true" default="false">Se true, cria uma string SQL para criar uma tabela com base na primeira linha do Store.</param> </params> <return type="array">Retorna um array onde cada elemento corresponde a uma linha INSERT.</return> </method> <method name="trimStore" visibility="public" example=""> <description>Retira espaços em branco do início e final de cada célula do Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> </params> <return type="array">Retorna um Store.</return> </method> <method name="prepareToJson" visibility="public" example=""> <description>corrige problemas com caracteres especiais que causam erros com json_encode().</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> </params> <return type="array">Retorna um Store.</return> </method> <method name="fromODBC" visibility="public" example=""> <description>Converte um resultado de uma busca SQL ODBC em um Store.</description> <params> <param type="resource" name="$result" optional="false" default="">O resource de resultado ODBC.</param> </params> <return type="array">Retorna um Store contendo os dados da busca ODBC.</return> </method> <method name="toXml" visibility="public" example="store_toxml.php"> <description>Converte um Store em uma string XML.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> <param type="string" name="$encoding" optional="true" default="UTF-8">A codificação de caractere.</param> <param type="int" name="$pagesize" optional="true" default="10">O tamanho da página, em número de linhas.</param> </params> <return type="array">Retorna uma string XML.</return> </method> <method name="fromXml" visibility="public" example="store_fromxml.php"> <description>Converte o conteúdo de um arquiv XML em um Store.</description> <params> <param type="string" name="$file" optional="false" default="">O arquivo XML.</param> <param type="boolean" name="$string" optional="true" default="false">Se true, não processa o arquivo, mas uma string XML passada em $file.</param> </params> <return type="array">Retorna um Store contendo os dados do arquivo XML.</return> </method> <method name="renameCol" visibility="public" example="store_renamecol.php"> <description>Renomeia colunas de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> <param type="array" name="$rename" optional="false" default="">Um array com os nomes das colunas a serem renomeadas como chave e os novos nomes como valores de cada chave.</param> </params> <return type="array">Retorna um Store com as colunas renomeadas.</return> </method> <method name="toHtml" visibility="public" example="store_tohtml.php"> <description>Converte um Store para uma tabela HTML.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> </params> <return type="string">Uma string com o código HTML da tabela.</return> </method> <method name="setTypeFields" visibility="public" example="store_settypefields.php"> <description>Configura os tipos dos valores das colunas de um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> </params> <return type="array">Uma matriz com as colunas e os respectivos tipos de dados no formato coluna => tipo. Aceita os tipos da função settype() do PHP.</return> </method> <method name="cross" visibility="public" example="cross.php"> <description>Realiza referências cruzadas com um Store.</description> <params> <param type="array" name="$store" optional="false" default="">O Store.</param> <param type="string" name="$line" optional="false" default="">O nome da coluna que servirá como base para as linhas.</param> <param type="string" name="$col" optional="false" default="">O nome da coluna que servirá como base para as colunas.</param> <param type="string" name="$value" optional="false" default="">O nome da coluna que servirá como base para os campos de valores.</param> <param type="string" name="$valuefn" optional="true" default="sum">O nome da função que agregará os dados da coluna $value. Deve ser o nome de um dos métodos da classe XtMath.</param> <param type="string" name="$linefn" optional="true" default="">O nome da função totalizadora das linhas. Deve ser o nome de um dos métodos da classe XtMath.</param> <param type="string" name="$colfn" optional="true" default="">O nome da função totalizadora das colunas. Deve ser o nome de um dos métodos da classe XtMath.</param> </params> <return type="array">Um Store.</return> </method> </methods> </class> </document>