Você está na página 1de 5

A U L A

06
Convenes para Nomenclatura

Introduo Linguagem do Visual FoxPro Parte 2

Por questes de padronizao e melhor legibilidade do cdigo fonte produzido por diversos desenvolvedores, recomenda-se que se siga um certo padro para nomear os elementos a serem programados. Tais elementos podem ser: Variveis Constantes Campos de Tabelas Objetos Controles

Embora se recomende, no obrigatria a sua utilizao. No entanto, um bom desenvolvedor com certeza ir padronizar seu cdigo, a fim de aumentar a sua prpria produtividade e ainda facilitar a vida de outras pessoas que porventura venham ter contato com seu cdigo. A seguir, vamos tentar descrever atravs de algumas tabelas os padres sugeridos pela Microsoft. Convenes para Nomemclatura de Variveis Siga o formato abaixo sugerido para nomear variveis. Sintaxe [Escopo]TipoNome Argumentos Escopo Opcional. Uma conveno para especificar o intervalo de referncia da varivel. Por exemplo, variveis locais s podem receber prefixo l (ele minsculo), lembrando-o que elas podem ser referenciadas apenas dentro do procedimento em que foram definidas. As expresses sugeridas para Escopo so as seguintes.

A U L A

06
Escopo L P G Descrio Local Particular (padro) Pblica (global) Exemplo lnCounter pnStatus gnOldRecno

Tipo Especifica o tipo de dados da varivel. Os prefixos sugeridos para Tipo so os seguintes. Tipo A C Y D T B F L N O U Comentrios Os prefixos no so requeridos, porm so recomendveis como bom procedimento de programao. O uso de um prefixo no dita o valor de uma varivel no Visual FoxPro, os prefixos so utilizados apenas como uma conveno de nome. Por exemplo, adicionar o prefixo c no verifica se apenas dados de caractere esto armazenados para a varivel, porm til para lembr-lo de que varivel foi criada para aceitar dados de caractere. Observao O prefixo do escopo recomendvel, mas no requerido. Em alguns casos, o escopo explcito no se aplica. Por exemplo, no programa principal de um aplicativo independente, no existe diferena em termos de visibilidade entre variveis com o escopo PBLICA ou PARTICULAR. O prefixo do tipo sempre relevante, sendo obrigatrio em programas de exemplo, que serviro para outros desenvolvedores. Descrio Matriz Caractere Moeda Data Data e Hora Duplo Flutuante Lgico Numrico Objeto Desconhecido Exemplo aMonths cLastName yCurrentValue dBirthDay tLastModified bValue fInterest lFlag nCounter oEmployee uReturnValue

Convenes de nomenclatura de constantes Siga o formato abaixo para nomear constantes.

Copyright 2004 Fox Total Network Todos os direitos reservados

A U L A

06
Sintaxe #DEFINE NOME_CONSTANTE [cValor][nValor][dValor]... Sendo que: #DEFINE o comando de definio de constante. NOME_CONSTANTE representa o nome da constante a ser definida. [cValor][nValor][dValor]... representa o valor a ser atribudo constante, sendo que pode ser qualquer tipo de dado aceito em variveis no Visual FoxPro. Comentrios Recomenda-se digitar as constantes em letras maisculas. Exemplo #DEFINE VALOR_MAXIMO 10

Convenes para Nomenclatura de Campos de Tabelas Siga o formato abaixo sugerido para nomear campos de tabelas. Estas convenes so recomendveis, mas no so obrigatrias. Sintaxe Alias.TipoNome Argumentos Tipo Especifica o tipo de dados de um campo em uma tabela. Os prefixos sugeridos para Tipo so os seguintes. Tipo C D T B F G L M Descrio Caractere Data Data e Hora Duplo Flutuante Geral Lgico Memo Exemplo Cliente.cLastName Cliente.dBirthDay Cliente.tLastMod Cliente.bRate Cliente.fValue Cliente.gPicture Cliente.lSellMail Cliente.mComments

Copyright 2004 Fox Total Network Todos os direitos reservados

A U L A

06
Y N I Moeda Numrico Nmero inteiro Cliente.yYearTDate Cliente.nItems Cliente.iCustID

Comentrios Os prefixos no so obrigatrios, porm so recomendveis como bom procedimento de programao. O uso de prefixo no dita o contedo de um campo no Visual FoxPro, os prefixos so utilizados apenas como uma conveno para nomenclatura. Por exemplo, adicionar o prefixo d no verifica se o contedo de um campo uma data, mas o ajuda a lembrar-se do tipo de dados contido no campo. Opinio Particular Apesar de recomendvel, no costumo utilizar prefixos para campos de tabelas simplesmente pela razo que quando utilizo vrios bancos de dados de produtores diferentes, por exemplo, SQL Server, Oracle, PostgreSQL e outros, h uma tendncia aos dados derivarem de tipos de um para outro. E se eu manter essa nomenclatura, acabarei por ter algum tipo de confuso futuramente.

Convenes para Nomenclatura de Objetos e Controles Embora os prefixos no sejam requeridos, utiliz-los tornar nosso cdigo bem mais profissional e fcil de ser entendido. A seguir est uma lista dos prefixos sugeridos pela Microsoft: Prefixo Chk Col Cbo Cmd Cmg Cnt Ctl Cad <userdefined> Dte Edt Tipo de Objeto CheckBox Collection ComboBox CommandButton CommandGroup Container Control CursorAdapter Custom DataEnvironment EditBox Exemplo chkReadOnly colFormObjects cboEnglish cmdCancel cmgChoices cntMoverList ctlFileList cadInventory user-defined dteSalesForm edtTextArea

Copyright 2004 Fox Total Network Todos os direitos reservados

A U L A

06
Frm Frs Grd Grc Grh Hpl Img Lbl Lin Lst Olb Ole Opt Opg Pag Pgf Prj Sep Shp Spn Txt Tmr Tbr Xad Xfd Xtb Form FormSet Grid Column Header HyperLink Image Label Line ListBox OLEBoundControl OLE OptionButton OptionGroup Page PageFrame ProjectHook Separator Shape Spinner TextBox Timer ToolBar XMLAdapter XMLField XMLTable frmFileOpen frsDataEntry grdPrices grcCurrentPrice grhTotalInventory hplHomeURL imgIcon lblHelpMessage linVertical lstPolicyCodes olbObject1 oleObject1 optFrench opgType pagDataUpdate pgfLeft prjBuildAll sepToolSection1 shpCircle spnValues txtGetText tmrAlarm tbrEditReport xadRemoteXMLData xfdPrices xtbInventory

Copyright 2004 Fox Total Network Todos os direitos reservados