Bucket sort — distribute, sort and combine

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <errno.h>

stdio.h supplies terminal input/output. stdlib.h declares conversion and allocation functions. string.h supplies string and memory utilities. ctype.h supplies isspace, and errno.h supplies conversion error reporting. Headers declare facilities; including them does not execute an operation.

/* Read one entire token; reject malformed, oversized and out-of-range input. */
int readToken(char text[], size_t capacity) {
    int ch; size_t used = 0; int fits = 1;

readToken receives a writable buffer and its capacity. ch is int so it can represent EOF as well as input characters. used counts stored characters, and fits starts as a success flag. One slot must remain for the null terminator.

    while ((ch = getchar()) != EOF && isspace((unsigned char)ch)) { }
    if (ch == EOF) return 0;

Read until a non-whitespace character appears. The unsigned-char cast supplies an allowed value to isspace. Return 0 if EOF arrives before a token begins.

    do {
        if (ch == 0) fits = 0;
        if (used + 1 < capacity) text[used++] = (char)ch;
        else fits = 0;

The do body handles the character already read. An embedded zero byte marks the token invalid. Store a character only while there is room for it and a null terminator; otherwise clear fits. Continue reading even after the buffer fills.

        ch = getchar();
    } while (ch != EOF && !isspace((unsigned char)ch));
    text[used] = '\0';
    return fits;
}

Read through the next whitespace or EOF, add a null character after the stored prefix, then return fits. A too-long token returns 0 rather than pretending that its stored prefix is the complete token.

int readInt(int *value) {
    char token[64], *end;
    if (!readToken(token, sizeof token)) return 0;

value is an output address. A 64-slot local buffer receives the token; a failed token read returns 0 before attempting conversion.

    errno = 0; long result = strtol(token, &end, 10);
    if (errno || end == token || *end || result < -1000000 || result > 1000000) return 0;

Reset errno before strtol. &end receives the stopping address. Reject conversion errors, no converted digits, leftover characters, or values outside -1,000,000 to 1,000,000. Thus 12x is not accepted as the integer 12.

    *value = (int)result; return 1;
}
int invalid(void) { puts("Invalid or incomplete input."); return 1; }

Store a validated integer through *value and return 1 from readInt. invalid is a separate helper that prints the error and returns 1 as main’s failure status; the same number has different roles in these two function contracts.

#define MAX_N 100
int readArray(int a[], int *n, int nonnegative) {
    if (!readInt(n) || *n < 1 || *n > MAX_N) return 0;

MAX_N is 100. readArray receives an array, the caller’s count address, and a flag requesting nonnegative values. Require a count from 1 to 100; return 0 before using an invalid count.

    for (int i = 0; i < *n; ++i)
        if (!readInt(&a[i]) || (nonnegative && a[i] < 0)) return 0;
    return 1;
}

readInt checks each complete integer token. If nonnegative is nonzero, negative elements are also rejected. Return 1 only after every requested element has been accepted.

void printArray(const int a[], int n) {
    printf("Sorted:"); for (int i = 0; i < n; ++i) printf(" %d",a[i]); putchar('\n');
}

printArray reads the first n elements without modifying them. It prints the Sorted label, a space before each value, and a final newline.

#define BUCKETS 10
void bucketSort(int a[], int n) {
    int buckets[BUCKETS][MAX_N], count[BUCKETS] = {0}, max = a[0];
    for (int i = 1; i < n; ++i) if (a[i] > max) max = a[i];

Each bucket row can hold up to MAX_N items. The zeroed count array tracks used slots in each bucket. Find max to scale the nonnegative inputs across the bucket indexes.

    for (int i = 0; i < n; ++i) {
        int b = (int)((long long)a[i] * BUCKETS / ((long long)max + 1));
        buckets[b][count[b]++] = a[i];
    }

Compute floor(value × 10 / (max + 1)). Using max + 1 keeps even the largest value below bucket index 10; it is also positive for all-zero input. Cast before multiplication to use wider arithmetic. Store into the bucket’s next slot and increase its count.

    int out = 0;
    for (int b = 0; b < BUCKETS; ++b) {
        /* Stable insertion sort is essential: distribution alone is not sorting. */
        for (int i = 1; i < count[b]; ++i) {
            int key = buckets[b][i], j = i - 1;

out starts at zero for final output. Visit buckets in increasing index order. Within a bucket, take each later element as key and begin checking its left neighbour.

            while (j >= 0 && buckets[b][j] > key) {
                buckets[b][j + 1] = buckets[b][j]; --j;
            }
            buckets[b][j + 1] = key;
        }

Check j >= 0 before accessing the left element. Shift larger values right until the key’s position is found, then write key into j + 1. Distribution alone does not sort values that share one bucket.

        for (int i = 0; i < count[b]; ++i) a[out++] = buckets[b][i];
    }
}

Copy each used bucket item into a[out++] before moving to the next bucket. The scaling order between buckets and the sort within each bucket together produce ascending output.

int main(void) {
    int a[MAX_N], n; if (!readArray(a,&n,1)) return invalid();
    bucketSort(a,n); printArray(a,n); return 0;
}

Read at least one and at most 100 nonnegative integers, call bucketSort, display the updated array and return success.