<commit_before>/***************************************************************************
*
*  $MCD Mdulo de definio: Mdulo Corpo Docente
*
*  Arquivo gerado:              corpoDocente.h
*  Letras identificadoras:      CDO
*
*  Nome da base de software:    Fonte do mdulo Corpo Docente
*
*  Projeto: Disciplina INF 1301
*  Gestor:  DI/PUC-Rio
*  Autores: <NAME>, BM  
*			<NAME>, FA
*			<NAME>, NP
*			<NAME>, MR
*			<NAME>, RP.
*
*  $HA Histrico de evoluo:
*     Verso	Autor		Data		Observaes
*       0.30   BM   02/10/2017	Prottipos adicionados 
*       0.20   BM   02/10/2017	Funcoes modelo adicionadas 
*       0.10   BM   01/10/2017	Inicio do desenvolvimento 
*
*  $ED Descrio do mdulo
*	  TODO
*
***************************************************************************/
typedef enum{
	CDO_CondRetOk,
	CDO_CondRetNaoHaMemoria,
	CDO_CondRetNaoExisteCorpo,
	CDO_CondRetProfessorNaoEncontrado,
	CDO_CondRetIdJaCriado,
	CDO_CondRetFormatoInvalido
} CDO_tpCondRet;

CDO_tpCondRet CDO_cria();
CDO_tpCondRet CDO_cadastra(char *nome, int rg, char *cpf, int matricula, char *email, int telefone, int dia, int mes, int ano, char *pais, char *uf, char *cidade, char *bairro, char *rua, int numero, char *complemento);
CDO_tpCondRet CDO_mostraAtual();
CDO_tpCondRet CDO_mostraTodos();
CDO_tpCondRet CDO_retira();
CDO_tpCondRet CDO_limpa();
CDO_tpCondRet CDO_libera();

CDO_tpCondRet CDO_buscaPorNome(char *chave);
CDO_tpCondRet CDO_buscaPorEmail(char *chave);
CDO_tpCondRet CDO_buscaPorCpf(char *chave);
CDO_tpCondRet CDO_buscaPorRg(int chave);

CDO_tpCondRet CDO_consultaNome(char *nome);
CDO_tpCondRet CDO_consultaRg(int *rg);
CDO_tpCondRet CDO_consultaCpf(char *cpf);
CDO_tpCondRet CDO_consultaMatricula(int *matricula);
CDO_tpCondRet CDO_consultaEmail(char *email);
CDO_tpCondRet CDO_consultaTelefone(int *tel);
CDO_tpCondRet CDO_consultaDataNascimento(int *dia, int *mes, int *ano);
CDO_tpCondRet CDO_consultaEndereco(char *pais, char *uf, char *cidade, char *bairro, char *rua, int *numero, char *complemento);

CDO_tpCondRet CDO_alteraNome(char *nome);
CDO_tpCondRet CDO_alteraRg(int rg);
CDO_tpCondRet CDO_alteraCpf(char *cpf);
CDO_tpCondRet CDO_alteraMatricula(int matricula);
CDO_tpCondRet CDO_alteraEmail(char* email);
CDO_tpCondRet CDO_alteraTelefone(int tel);
CDO_tpCondRet CDO_alteraDataNascimento(int dia, int mes, int ano);
CDO_tpCondRet CDO_alteraEndereco(char *pais, char *uf, char *cidade, char *bairro, char *rua, int numero, char *complemento);<commit_msg>Inicio da Documentação do corpoDocente.h<commit_after>/***************************************************************************
*
*  $MCD Mdulo de definio: Mdulo Corpo Docente
*
*  Arquivo gerado:              corpoDocente.h
*  Letras identificadoras:      CDO
*
*  Nome da base de software:    Fonte do mdulo Corpo Docente
*
*  Projeto: Disciplina INF 1301
*  Gestor:  DI/PUC-Rio
*  Autores: <NAME>, BM  
*			<NAME>, FA
*			<NAME>, NP
*			<NAME>, MR
*			<NAME>, RP.
*
*  $HA Histrico de evoluo:
*     Verso	Autor		Data		Observaes
*       0.30   BM   02/10/2017	Prottipos adicionados 
*       0.20   BM   02/10/2017	Funcoes modelo adicionadas 
*       0.10   BM   01/10/2017	Inicio do desenvolvimento 
*
*  $ED Descrio do mdulo
*	  TODO
*
***************************************************************************/
typedef enum{
	CDO_CondRetOk,
	CDO_CondRetNaoHaMemoria,
	CDO_CondRetNaoExisteCorpo,
	CDO_CondRetProfessorNaoEncontrado,
	CDO_CondRetIdJaCriado,
	CDO_CondRetFormatoInvalido
} CDO_tpCondRet;

CDO_tpCondRet CDO_cria();
CDO_tpCondRet CDO_cadastra(char *nome, int rg, char *cpf, int matricula, char *email, int telefone, int dia, int mes, int ano, char *pais, char *uf, char *cidade, char *bairro, char *rua, int numero, char *complemento);
CDO_tpCondRet CDO_mostraAtual();
CDO_tpCondRet CDO_mostraTodos();
CDO_tpCondRet CDO_retira();
CDO_tpCondRet CDO_limpa();
CDO_tpCondRet CDO_libera();

/***********************************************************************
*
*  $FC Funo: CDO Busca por Nome
*
*  $ED Descrio da funo
*     Busca no Corpo Docente (Lista de Professores) um Professor pelo Nome
*
*  $EP Parmetros
*     
*     $P chave - Nome do Professor que deseja buscar no corpo Docente
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*     CDO_CondRetProfessorNaoEncontrado - Instncia de professor desejada no encontrada no encontrado no Corpo Docente
*     CDO_CondRetNaoExisteCorpo - Caso no exista uma Instncia de Corpo Docente 
*
*  Assertiva de Entrada: 
*		-A chave tem at 80 caracteres
*                    
*  Assertiva de Sada: 
*		-Caso exista uma instncia de Professor com o Nome igual aquele enviado para a funo via parmetro a funo retorno condio OK
*		-Caso no exista uma instncia de Professor com o Nome igual aquele enviado para a funco via parmetro a funo retorna condio de Prof no encontrado
*		-Caso no exista Corpo Docente vlido a funo retorna No Existe Corpo
*
***********************************************************************/

CDO_tpCondRet CDO_buscaPorNome(char *chave);

/***********************************************************************
*
*  $FC Funo: CDO Busca por Email
*
*  $ED Descrio da funo
*     Busca no Corpo Docente (Lista de Professores) um Professor pelo Email
*
*  $EP Parmetros
*     
*     $P chave - Email do Professor que deseja buscar no corpo Docente
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*     CDO_CondRetProfessorNaoEncontrado - Instncia de professor desejada no encontrada no Corpo Docente
*     CDO_CondRetNaoExisteCorpo - Caso no exista uma Instncia de Corpo Docente 
*
*  Assertiva de Entrada: 
*		-A chave tem at 80 caracteres
*                    
*  Assertiva de Sada: 
*		-Caso exista uma instncia de Professor com o Email igual aquele enviado para a funo via parmetro a funo retorno condio OK
*		-Caso no exista uma instncia de Professor com o Email igual aquele enviado para a funco via parmetro a funo retorna condio de Prof no encontrado
*		-Caso no exista Corpo Docente vlido a funo retorna No Existe Corpo
*
***********************************************************************/

CDO_tpCondRet CDO_buscaPorEmail(char *chave);

/***********************************************************************
*
*  $FC Funo: CDO Busca por CPF
*
*  $ED Descrio da funo
*     Busca no Corpo Docente (Lista de Professores) um Professor pelo CPF
*
*  $EP Parmetros
*     
*     $P chave - CPF do Professor que deseja buscar no corpo Docente
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*     CDO_CondRetProfessorNaoEncontrado - Instncia de professor desejada no encontrada no Corpo Docente
*     CDO_CondRetNaoExisteCorpo - Caso no exista uma Instncia de Corpo Docente 
*
*  Assertiva de Entrada: 
*		-A chave tem at 80 caracteres
*                    
*  Assertiva de Sada: 
*		-Caso exista uma instncia de Professor com o CPF igual aquele enviado para a funo via parmetro a funo retorno condio OK
*		-Caso no exista uma instncia de Professor com o CPF igual aquele enviado para a funco via parmetro a funo retorna condio de Prof no encontrado
*		-Caso no exista Corpo Docente vlido a funo retorna No Existe Corpo
*
***********************************************************************/

CDO_tpCondRet CDO_buscaPorCpf(char *chave);

/***********************************************************************
*
*  $FC Funo: CDO Busca por RG
*
*  $ED Descrio da funo
*     Busca no Corpo Docente (Lista de Professores) um Professor pelo RG
*
*  $EP Parmetros
*     
*     $P chave - RG do Professor que deseja buscar no corpo Docente
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*     CDO_CondRetProfessorNaoEncontrado - Instncia de professor desejada no encontrada no Corpo Docente
*     CDO_CondRetNaoExisteCorpo - Caso no exista uma Instncia de Corpo Docente 
*
*  Assertiva de Entrada: 
*		-A chave tem at 80 caracteres
*                    
*  Assertiva de Sada: 
*		-Caso exista uma instncia de Professor com o RG igual aquele enviado para a funo via parmetro a funo retorno condio OK
*		-Caso no exista uma instncia de Professor com o RG igual aquele enviado para a funco via parmetro a funo retorna condio de Prof no encontrado
*		-Caso no exista Corpo Docente vlido a funo retorna No Existe Corpo
*
***********************************************************************/

CDO_tpCondRet CDO_buscaPorRg(int chave);

/***********************************************************************
*
*  $FC Funo: CDO Consulta Nome
*
*  $ED Descrio da funo
*     Consulta o Nome da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P nome - Cadeia de caracteres que receber o nome do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para o a cadeia nome  vlido
*                    
*  Assertiva de Sada: 
*	    - necessrio que a Funo PRF_consultaNome tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o conteudo do ponteiro para nome ser preenchido com o nome do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaNome(char *nome);

/***********************************************************************
*
*  $FC Funo: CDO Consulta RG
*
*  $ED Descrio da funo
*     Consulta o RG da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P rg - Inteiro que receber o rg do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para o inteiro RG  vlido
*                    
*  Assertiva de Sada: 
*	    - necessrio que a Funo PRF_consultaRg tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o contedo do ponteiro para RG ser preenchido com o RG do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaRg(int *rg);

/***********************************************************************
*
*  $FC Funo: CDO Consulta CPF
*
*  $ED Descrio da funo
*     Consulta o CPF da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P cpf - Cadeia de caracteres que receber o cpf do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para o cadeia CPF  vlido
*                    
*  Assertiva de Sada: 
*	    - necessrio que a Funo PRF_consultaCpf tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o contedo do ponteiro para CPF ser preenchido com o CPF do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaCpf(char *cpf);

/***********************************************************************
*
*  $FC Funo: CDO Consulta Matricula
*
*  $ED Descrio da funo
*     Consulta a Matricula da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P matricula - Inteiro que receber o cpf do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para o inteiro matricula  vlido
*                    
*  Assertiva de Sada: 
*	    - necessrio que a Funo PRF_consultaMatricula tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o contedo do ponteiro para matricula ser preenchido com a matricula do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaMatricula(int *matricula);

/***********************************************************************
*
*  $FC Funo: CDO Consulta Email
*
*  $ED Descrio da funo
*     Consulta o Email da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P email - Cadeia de Caracteres que receber o cpf do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para a cadeia email  vlido
*                    
*  Assertiva de Sada: 
*	    - necessrio que a Funo PRF_consultaEmail tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o contedo do ponteiro para email ser preenchido com o email do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaEmail(char *email);

/***********************************************************************
*
*  $FC Funo: CDO Consulta Telefone
*
*  $ED Descrio da funo
*     Consulta o Telefone da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P telefone - Inteiro que receber o cpf do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para o inteiro telefone  vlido
*                    
*  Assertiva de Sada: 
*	    - necessrio que a Funo PRF_consultaTelefone tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o contedo do ponteiro para telefone ser preenchido com o telefone do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaTelefone(int *tel);

/***********************************************************************
*
*  $FC Funo: CDO Consulta Data de Nasciemnto
*
*  $ED Descrio da funo
*     Consulta a data de Nascimento da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P dia - Inteiro que receber o dia de nascimento do professor selecionado, por referncia
*	  $P mes - Inteiro que receber o mes de nascimento do professor selecionado, por referncia
*     $P ano - Inteiro que receber o ano de nascimento do professor selecionado, por referncia
*
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-O ponteiro para o inteiro dia  vlido
*		-O ponteiro para o inteiro mes  vlido
*		-O ponteiro para o inteiro ano  valido
*                    
*  Assertiva de Sada: 
*	    - necessrio que as funo  PRF_consultaDiaNascimento,	PRF_consultaMesNascimento, PRF_consultaAnoNascimento tenha suas assertivas de entrada e saida corretamente implementadas
*       -Caso isso ocorra o contedo dos ponteiros para dia/mes/ano sero preenchidos com o dia/mes/ano da data de nascimento do Professor em questo
*
***********************************************************************/

CDO_tpCondRet CDO_consultaDataNascimento(int *dia, int *mes, int *ano);

/***********************************************************************
*
*  $FC Funo: CDO Consulta Endereo
*
*  $ED Descrio da funo
*     Consulta o Endereo da instncia de Professor selecionada naquele momento
*
*  $EP Parmetros     
*     $P pais - Cadeia de Caracteres que receber o pais de moradia do professor selecionado, por referncia
*	  $P uf - Cadeia de Caracteres que receber o uf de moradia do professor selecionado, por referncia
*     $P cidade - Cadeia de Caracteres que receber a cidade de moradia do professor selecionado, por referncia
*     $P bairro - Cadeia de Caracteres que receber o bairro de moradia do professor selecionado, por referncia
*	  $P rua - Cadeia de Caracteres que receber o a rua de moradia professor selecionado, por referncia
*     $P numero - Inteiro que receber o numero da moradia do professor selecionado, por referncia
*     $P complemento - Cadeia de Caracteres que receber o complemento da moradia do professor selecionado, por referncia
*						
*  $FV Valor retornado
*     CDO_CondRetOk 
*
*  Assertiva de Entrada: 
*		-
*                    
*  Assertiva de Sada: 
*	    -
*       -
*
***********************************************************************/

CDO_tpCondRet CDO_consultaEndereco(char *pais, char *uf, char *cidade, char *bairro, char *rua, int *numero, char *complemento);

CDO_tpCondRet CDO_alteraNome(char *nome);
CDO_tpCondRet CDO_alteraRg(int rg);
CDO_tpCondRet CDO_alteraCpf(char *cpf);
CDO_tpCondRet CDO_alteraMatricula(int matricula);
CDO_tpCondRet CDO_alteraEmail(char* email);
CDO_tpCondRet CDO_alteraTelefone(int tel);
CDO_tpCondRet CDO_alteraDataNascimento(int dia, int mes, int ano);
CDO_tpCondRet CDO_alteraEndereco(char *pais, char *uf, char *cidade, char *bairro, char *rua, int numero, char *complemento);
{'fraction_non_alphanumeric': 0.1794480400537306, 'fraction_numerical': 0.005006716326779827, 'mean_word_length': 4.067759900990099, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 13, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2303250', 'n_tokens_mistral': 5910, 'n_tokens_neox': 5629, 'n_words': 1731}