https://github.com/artnum/strid

Generate random short identifier in base36 with crc
https://github.com/artnum/strid

base36 crc-8 crc8 id random shorturl text

Last synced: 3 months ago
JSON representation

Generate random short identifier in base36 with crc

• Host: GitHub
• URL: https://github.com/artnum/strid
• Owner: artnum
• License: other
• Created: 2017-06-10T15:59:40.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-06-12T14:20:52.000Z (over 8 years ago)
• Last Synced: 2025-06-15T16:13:41.951Z (4 months ago)
• Topics: base36, crc-8, crc8, id, random, shorturl, text
• Language: C
• Size: 10.7 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.TXT

Awesome Lists containing this project

README

          
STRID

=====

Generate random id 10 char long, by default. Uses base 36 encoding and include a checksum. It can be useful for application that need to send id through HTTP or any character-based protocol.

Usage

-----

Initialize the random number generator (use drand48()) by passing any string to strid_init(). Initialization with a static string will produce predictible results. You don't need to initialize, just you should.

    int main(void) {

        Strid myId;

        strid_init("Not So Random String");

        strid_generate_random(myId);

        printf("%s\n", myId);

        return 0;

    }

You can prefix your ID with strid_generate_prefix().

	int main(void) {

		/* ... */

		

		strid_generate_prefix(myId, "hostname.example.com");

		

		/* ... */

	}

If the id comes from an extern source, you might want to verify it.

    int main(void) {

        /* ... */

        if(strid_valid(externId)) {

            printf("Valid ID");

        }

        /* ... */

    }

Two id can be compared with strcmp but, in case characters have been lowered, you might well use strid_equal.

    int main(void) {

    

        /* ... */

        if(strid_equal(Id1, Id2)) {

            printf("ID1 equals ID2");

        }

        /* ... */

        

    }

Please note that strid_equal doesn't validate the id at any point. So check first both ids with strid_valid and then strid_equal.

You can copy an id into another id with strid_copy.

    int main(void) {

        /* ... */

       strid_copy(idDest, idSource);

       /* ... */

    }

It's just a memcpy, see in strid.h :

    #define strid_copy(dest, src)           memcpy((dest), (src), STRID_MAX_SIZE)

License

-------

BSD 2-clauses, see LICENSE.txt