production/code_guide/create__guid_8cpp_source.html

/*****************************************************************************\

*                                                                             *

*  Name   : create_guid                                                       *

*  Author : Chris Koeritz                                                     *

*                                                                             *

*  Purpose:                                                                   *

*                                                                             *

*    This program generates a globally unique identifier using the operating  *

*  system's support.  The resulting id can be used to tag items that must be  *

*  uniquely named.                                                            *

*                                                                             *

*******************************************************************************

* Copyright (c) 2006-$now By Author.  This program is free software; you can  *

* redistribute it and/or modify it under the terms of the GNU General Public  *

* License as published by the Free Software Foundation; either version 2 of   *

* the License or (at your option) any later version.  This is online at:      *

*     http://www.fsf.org/copyleft/gpl.html                                    *

* Please send any updates to: fred@gruntose.com                               *

\*****************************************************************************/


#include <application/application_shell.h>

#include <application/hoople_main.h>

#include <application/windoze_helper.h>

#include <basis/astring.h>

#include <loggers/console_logger.h>

#include <mathematics/chaos.h>

#include <structures/static_memory_gremlin.h>

#include <textual/string_manipulation.h>


#ifdef __WIN32__

//  #define DO_GUIDS

//hmmm: currently disabled due to problems compiling in cygwin using this header; complains about new.h being missing.

#endif


#ifdef DO_GUIDS

  #include <comdef.h>

#endif


using namespace application;

using namespace basis;

using namespace loggers;

using namespace mathematics;

using namespace structures;

using namespace textual;


#define BASE_LOG(to_print) program_wide_logger::get().log(to_print, ALWAYS_PRINT)


// this is an example GUID in the DCE format:

//

//    {12345678-1234-1234-1234-123456789012}

//

// each position can be a hexadecimal digit, ranging from 0 to F.

// the full size is measured as 32 nibbles or 16 bytes or 128 bits.


class create_guid : public application_shell

{

public:

  create_guid() : application_shell() {}

  DEFINE_CLASS_NAME("create_guid");

  int execute();

};


int create_guid::execute()

{

  FUNCDEF("execute");

  SETUP_CONSOLE_LOGGER;

#ifndef DO_GUIDS

// this is completely bogus for the time being.  it just produces a random

// number rather than a guid.

  #define add_random \

    faux_guid += astring(string_manipulation::hex_to_char \

        (randomizer().inclusive(0, 0xf)), 1)


  astring faux_guid("{");

  for (int i = 0; i < 8; i++) add_random;

  faux_guid += "-";

  for (int j = 0; j < 3; j++) {

    for (int i = 0; i < 4; i++) add_random;

    faux_guid += "-";

  }

  for (int i = 0; i < 8; i++) add_random;

  faux_guid += "}";

  BASE_LOG(faux_guid.lower());

#elif defined (DO_GUIDS)

  GUID guid;

  CoCreateGuid(&guid);

  const int BUFFER_SIZE = 1024;

  LPOLESTR wide_buffer = new WCHAR[BUFFER_SIZE + 4];

  StringFromGUID2(guid, wide_buffer, BUFFER_SIZE);

  const int BYTE_BUFFER_SIZE = BUFFER_SIZE * 2 + 4;

  char buffer[BYTE_BUFFER_SIZE];

  WideCharToMultiByte(CP_UTF8, 0, wide_buffer, -1, buffer, BYTE_BUFFER_SIZE,

      NULL, NULL);

  astring guid_text = buffer;

  delete [] wide_buffer;

  BASE_LOG(guid_text);

#else

  #error unknown operating system; no support for guids.

#endif


  return 0;

}


HOOPLE_MAIN(create_guid, )


#ifdef __BUILD_STATIC_APPLICATION__

  // static dependencies found by buildor_gen_deps.sh:

  #include <algorithms/sorts.cpp>

  #include <application/application_shell.cpp>

  #include <application/callstack_tracker.cpp>

  #include <application/command_line.cpp>

  #include <application/windoze_helper.cpp>

  #include <basis/astring.cpp>

  #include <basis/common_outcomes.cpp>

  #include <basis/environment.cpp>

  #include <basis/guards.cpp>

  #include <basis/mutex.cpp>

  #include <basis/utf_conversion.cpp>

  #include <configuration/application_configuration.cpp>

  #include <configuration/configurator.cpp>

  #include <configuration/ini_configurator.cpp>

  #include <configuration/ini_parser.cpp>

  #include <configuration/table_configurator.cpp>

  #include <configuration/variable_tokenizer.cpp>

  #include <filesystem/byte_filer.cpp>

  #include <filesystem/directory.cpp>

  #include <filesystem/filename.cpp>

  #include <loggers/combo_logger.cpp>

  #include <loggers/console_logger.cpp>

  #include <loggers/critical_events.cpp>

  #include <loggers/file_logger.cpp>

  #include <loggers/program_wide_logger.cpp>

  #include <structures/bit_vector.cpp>

  #include <structures/checksums.cpp>

  #include <structures/object_packers.cpp>

  #include <structures/static_memory_gremlin.cpp>

  #include <structures/string_hasher.cpp>

  #include <structures/string_table.cpp>

  #include <structures/version_record.cpp>

  #include <textual/byte_formatter.cpp>

  #include <textual/parser_bits.cpp>

  #include <textual/string_manipulation.cpp>

  #include <timely/earth_time.cpp>

  #include <timely/time_stamp.cpp>

#endif // __BUILD_STATIC_APPLICATION__


application_configuration.cpp

application_shell.cpp

application_shell.h

astring.cpp

astring.h

bit_vector.cpp

byte_filer.cpp

byte_formatter.cpp

callstack_tracker.cpp

chaos.h

checksums.cpp

application::application_shell
The application_shell is a base object for console programs.
Definition application_shell.h:33

application::application_shell::execute
virtual int execute()=0
< retrieves the command line from the /proc hierarchy on linux.

application::application_shell::application_shell
application_shell()
constructs an application_shell to serve as the root of the program.
Definition application_shell.cpp:49

basis::astring
Provides a dynamically resizable ASCII character string.
Definition astring.h:35

combo_logger.cpp

command_line.cpp

common_outcomes.cpp

configurator.cpp

console_logger.cpp

console_logger.h

SETUP_CONSOLE_LOGGER
#define SETUP_CONSOLE_LOGGER
< a macro that retasks the program-wide logger as a console_logger.
Definition console_logger.h:69

add_random
#define add_random

BASE_LOG
#define BASE_LOG(to_print)
Definition create_guid.cpp:46

critical_events.cpp

directory.cpp

earth_time.cpp

DEFINE_CLASS_NAME
#define DEFINE_CLASS_NAME(objname)
Defines the name of a class by providing a couple standard methods.
Definition enhance_cpp.h:42

FUNCDEF
#define FUNCDEF(func_in)
FUNCDEF sets the name of a function (and plugs it into the callstack).
Definition enhance_cpp.h:54

environment.cpp

file_logger.cpp

filename.cpp

guards.cpp

hoople_main.h
Provides macros that implement the 'main' program of an application.

HOOPLE_MAIN
#define HOOPLE_MAIN(obj_name, obj_args)
options that should work for most unix and linux apps.
Definition hoople_main.h:61

ini_configurator.cpp

ini_parser.cpp

mutex.cpp

application
Implements an application lock to ensure only one is running at once.
Definition application_shell.cpp:40

application::BUFFER_SIZE
const int BUFFER_SIZE
Definition redirecter.cpp:46

basis
The guards collection helps in testing preconditions and reporting errors.
Definition array.h:30

loggers
A logger that sends to the console screen using the standard output device.
Definition combo_logger.cpp:36

mathematics
An extension to floating point primitives providing approximate equality.
Definition averager.h:21

structures
A dynamic container class that holds any kind of object via pointers.
Definition amorph.h:55

textual
Definition byte_formatter.cpp:38

object_packers.cpp

parser_bits.cpp

program_wide_logger.cpp

sorts.cpp

static_memory_gremlin.cpp

static_memory_gremlin.h

string_hasher.cpp

string_manipulation.cpp

string_manipulation.h

string_table.cpp

table_configurator.cpp

time_stamp.cpp

utf_conversion.cpp

variable_tokenizer.cpp

version_record.cpp

windoze_helper.cpp

windoze_helper.h
Aids in achievement of platform independence.