Added some more useful docs and stuff.

This commit is contained in:
Nicolás A. Ortega 2016-12-14 16:14:58 +01:00
parent fcee95da17
commit 003b94dcdb
No known key found for this signature in database
GPG Key ID: 614272579C2070D1
2 changed files with 14 additions and 6 deletions

View File

@ -1,3 +1,10 @@
/**
* @file list.h
* @author Deathsbreed <deathsbreed@themusicinnoise.net>
* @brief Code responsible for List management.
* @details Code responsible for the definition and management of the
* List object.
*/
#pragma once
#include <gmp.h>
#include <stdbool.h>
@ -14,8 +21,7 @@ typedef struct {
/**
* @brief Initialize a List.
* @details Initialize the list and its variables, allocating memory
* to the pointer array inside. Returns true on success and false on
* failure.
* to the pointer array inside.
* @param[in] l A pointer to a List type to be initialized.
*/
void initList(List *restrict l);

View File

@ -7,6 +7,7 @@
#include "list.h"
static bool run;
void leave();
int main(void) {
@ -41,7 +42,10 @@ int main(void) {
do {
// Calculate half of `num'
mpz_fdiv_q_ui(halfNum, num, 2);
// Loop through found primes
/**
* Loop through primes we've found until we get to half of the number
* we're analyzing
*/
for(size_t i = 0; mpz_cmp(primes.list[i], halfNum) < 0; ++i) {
// If `num' is divisible by a prime then go to the next number
if(mpz_divisible_p(num, primes.list[i]) != 0)
@ -73,6 +77,4 @@ nextPrime:
return 0;
}
void leave() {
run = false;
}
void leave() { run = false; }