Completely not tested, but here you go.

void wait_for_keypress()
{
  ALLEGRO_EVENT_QUEUE *event_queue;
  ALLEGRO_EVENT event;
  
  al_install_keyboard();
  event_queue = al_create_event_queue();
  al_register_event_source(event_queue, al_get_keyboard_event_source());

  do
    al_wait_for_event(event_queue, &event);
  while (event.type != ALLEGRO_EVENT_KEY_DOWN);
  
  al_destroy_event_queue(event_queue);
}

Usually you would have the event loop already, because you need it for other stuff.

By the way, the C and C++ standard libraries don't have any GUI-related functions, just console.

Yeah, it's difficult to re-organize my thinking. I'm used to C and Allegro 4, now trying to use C++ and Allegro 5. I had a hard time sleeping last night, just had programming on my brain. , I realized what my mistake was, and that is I need to create an input class of some sort.

I had set up what was needed for getting input the normal Allegro 5 way, in a loop as discussed in other parts of the forum, but that's no good in a game that has separate functions.

After looking at the demos I noticed A5teroids has an input class, that helped me see how to do it properly I think, I haven't created it yet but I am enthusiastic again. I am SO not used to programming in C++, I was ready to switch back to C but that would make no difference because as mentioned, I noticed that all the input examples online have to do with CONSOLE input, which I find strange in 2012.

One thing I am learning, all the tutorials online in the world can't replace just experience, trial and error. Most of the tutorials give bad examples and teach bad habits that don't work well in actual games.

"The easier your solution is, the harder it will be on you later on" seems to be pretty accurate. ]

Edit 1: How would you handle keyboard input in C? In C++ you have classes. I assume there would be global variables for events? It would be handy to know as I am still not so certain I want to program in C++.

Edit 2: Okay, I got it working without classes for now, although I DO want to try my hand at creating an input class.

I initialize queue and timer etc.. in an initialize() function, timer and queue are global variables (I'm in trouble now)...

Oh, display is also a global, I originally done this so I can have a shutdown() function that can be called from anywhere in the program which destroys bitmaps and other such things. Any suggestions for a better way is welcome, but this works, my globals are all grouped together so I can easily track them.

void initialize()
{
   // other initialize stuff here

   timer = al_create_timer(1.0 / 60);
   queue = al_create_event_queue();
   al_register_event_source(queue, al_get_keyboard_event_source());
   al_register_event_source(queue, al_get_display_event_source(display));
   al_register_event_source(queue, al_get_timer_event_source(timer));
   al_start_timer(timer);
}

and then I have the wait_for_keypress() in it's own function...

void wait_for_keypress()
{
  do
    al_wait_for_event(queue, &event);
  while (event.type != ALLEGRO_EVENT_KEY_DOWN);
}

Now that I have this working, I think it should be easier to translate it into an input class if I so choose.

I have this in my main() currently. I still have a lot of work to do on this project and quit a bit will change. I just wanted a simple way to wait for a key press on an opening title screen that will only be seen once.

This works so far, I'm feeling less and less comfortable with C++, currently my project is being compiled as C99. But I may still switch back, old habits die hard.

In my old game (this is a new version, I am rewriting) I had code in that detected when the game lost focus (alt+tab) and paused the game. I'm not sure how that works now, if that is what you are talking about. I just started on this recently so it isn't too far along to change.

OH, you mean in my wait for key press, change it so that it can detect when the game loses focus? (also in the main game loop)

If it looses focus, skip any key processing until it regains it back.

Also, I used to have my while() loop set up like you originally suggested, then I changed it to add in that do while() loop, now I am wondering if I shouldn't go back to the way you suggested so that if the game loses focus I could more easily jump to the draw section briefly to update the screen?

So much to think about...