{"id":5559,"date":"2022-10-08T00:01:19","date_gmt":"2022-10-08T07:01:19","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=5559"},"modified":"2022-10-01T10:36:24","modified_gmt":"2022-10-01T17:36:24","slug":"playing-with-ha-yuge-gmp-integers","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=5559","title":{"rendered":"Playing with Ha-Yuge GMP Integers"},"content":{"rendered":"

I’ve written a few books on using external libraries, which I shamelessly plug later in this post. After confirming that the library is installed (see last week’s post<\/a>), the next step isn’t to code, but rather to peruse the online documentation, the API or Application Programming Interface.
\n
\nFor the GMP library, which handles painfully large integers, the API or online manual is found here: https:\/\/gmplib.org\/manual\/index<\/a><\/p>\n

Don’t expect any handholding. Programmers write to other programmers. Often they’re so immersed in the topic they forget about people who are just starting out. That’s okay; it’s the reason you’re reading this blog and not the official GNU manual. But do check out the manual.<\/p>\n

The GMP integer values are stored as structures cast as the mpz_t<\/em> datatype. (I assume the structure’s contents are revealed somewhere on the library’s website, though knowing the details isn’t necessary.) So to use the huge integer values, you must follow certain procedures and use the specific functions available in the GMP library.<\/p>\n

Due to its construction, the mpz_t<\/em> datatype requires three steps to initialize; you cannot use the equal sign operator to assign a value:<\/p>\n

    \n
  1. Declare the mpz_t<\/em> variable.<\/li>\n
  2. Initialize the variable.<\/li>\n
  3. Assign the variable a value.<\/li>\n<\/ol>\n

    The declaration is simple:<\/p>\n

    mpz_t i;<\/code><\/p>\n

    This statement creates an mpz_t<\/em> variable i<\/code>. It allocates the structure, but like any variable declared in C, the contents are garbage. A second step is required:<\/p>\n

    mpz_init(i);<\/code><\/p>\n

    The mpz_init()<\/em> function initializes variable i<\/code>, setting its int<\/em> value to zero. The variable can now be used in the host of mpz<\/em> and gmp<\/em> functions.<\/p>\n

    To assign a value to the mpz_t<\/em> variable, you use one of an mpz_set<\/em> function:<\/p>\n

    mpz_set_ui(i,1000000000);<\/code><\/p>\n

    The mpz_set_ui()<\/em> function assigns an unsigned integer (ui<\/em>) value of one billion to mpz_t<\/em> variable i<\/code>. The variable can now be used in your code, but only with special functions. For example, the gmp_printf()<\/em> function, shown in this code:<\/p>\n

    2022_10_08-Lesson.c<\/a><\/h3>\n
    \r\n#include <gmp.h>\r\n\r\nint main()\r\n{\r\n    mpz_t i;\r\n    mpz_init(i);\r\n\r\n    \/* i equals one billion *\/<\/span>\r\n    mpz_set_ui(i,1000000000);\r\n    gmp_printf(\"%Zd\\n\",i);\r\n\r\n    return(0);\r\n}<\/pre>\n
    The gmp_printf()<\/em> function at Line 10 works like the standard printf()<\/em> function, though it’s capable of outputting mpz_t<\/em> values. The %Zd<\/code> placeholder outputs the mpz_t<\/em> value as a decimal number. Here’s a sample run:<\/p>\n
    1000000000<\/code><\/p>\n
    Impressive!<\/p>\n
    But this code is only a start.<\/p>\n
    As I wrote earlier, various mpz_set<\/em> functions are available to assign specific values to mpz_t<\/em> variables. For example, mpz_set_si()<\/em> to assign a signed int<\/em> value; mpz_set_d()<\/em> to assign a double<\/em>. The full list is available on this page<\/a>. You can even convert a value from a string.<\/p>\n
    The library also hosts functions that read standard input for assigning values, such as gmp_scanf()<\/em>. The manual lists the lot.<\/p>\n
    In next week’s Lesson, I cover some basic math and mpz_t<\/em> value manipulation.<\/p>\n
    Oh! Here are the books I’ve written that cover augmenting your C code by incorporating other libraries:<\/p>\n\n\n
    \n<\/a>\"\"\n<\/td>\n\n<\/a>\"\"\n<\/td>\n\n<\/a>\"\"
    \n<\/tr>\n<\/table>\n","protected":false},"excerpt":{"rendered":"
    With the GMP library installed, your code can play with integers of impressively large values. Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-5559","post","type-post","status-publish","format-standard","hentry","category-main"],"_links":{"self":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5559","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=5559"}],"version-history":[{"count":6,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5559\/revisions"}],"predecessor-version":[{"id":5570,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5559\/revisions\/5570"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5559"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=5559"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=5559"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}