Click here to Skip to main content
14,331,191 members

Function Overload by Return

Rate this:
4.40 (30 votes)
Please Sign up or sign in to vote.
4.40 (30 votes)
5 Apr 2007CPOL
Choosing the right function based on the return type


This code shows one way to use the C++ overload rule using the function return type instead of its signature. Of course, nothing is changed in the language, and the result just looks like a return type overload.


The function overload, in other words, reusing an existent function name but with different parameters, is something more or less known by the C++, Java and .NET community. As a sine qua non condition, we know that the overloaded function signature must be always different from its homonyms colleagues. The code below illustrates this:

GUID guid;
wstring guidS;

CreateNewGUID(guidS); // calls void CreateNewGUID(wstring&)
CreateNewGUID(guid);  // calls void CreateNewGUID(GUID&) (the compiler knows that)

It's a pretty common way to accept different input formats. But what about the output? How to extract different information or the same information in different format using the overload feature (e.g. the above example) without passing the result variable as a output argument? Giving ourselves some imagination and thinking how a valid construction would be, we can think of something like this:

GUID guid;
wstring guidS;

guidS = CreateNewGUID(); // calls wstring CreateNewGUID()
guid = CreateNewGUID();  // calls GUID CreateNewGUID() (the compiler knows that?)

Opening again our old and hurt C++ theories book, we can see the above code DOES NOT work. Or, at least, should not be. Just defining a couple of functions like that causes the following error:

error C2556: 'GUID CreateNewGUID(void)' : overloaded function differs 
	only by return type from 'std::wstring CreateNewGUID(void)'

That's right. Well, the error is right. The return type is not a function property that identifies it uniquely. Only the signature can do that (the parameters received by the function). AFAIK, this "limitation" is hack proof. Anyway, nothing disallows us to use another feature besides ordinary functions:

struct CreateNewGUID
   // what is supposed to be here?

We got it! Now we can "call" our "function" creating a new instance of the struct and attributing the "return" to a wstring or to our GUID struct:

guidS = CreateNewGUID(); 	// instantiates a CreateNewGUID
guid = CreateNewGUID(); 	// instantiates a CreateNewGUID. 
			// The difference is in the "return"

Using the Code

Since we create a new type, and knowing that this new type is different from the already known wstring and GUID types, we should simply convert our new type into every desirable return type:

struct CreateNewGUID
   operator wstring () { ... } 	// the conversion is the "function call"

   operator GUID () { ... } 	// as there's a couple of conversions... 
				// over... underload!

This concludes our somewhat odd solution to overload a "function" by the return type:

// instantiates a CreateNewGUID e calls CreateNewGUID::operator wstring()
guidS = CreateNewGUID();

// instantiates a CreateNewGUID e calls CreateNewGUID::operator GUID()
guid = CreateNewGUID();

There's the entire source.

/** @file underload.cpp
@brief A way to make overload using just the return type.
@author Wanderley Caloni
#include <windows.h>
#include <objbase.h>

#include <iostream />
#include <string>

using namespace std;

struct CreateNewGUID
   operator wstring () // the first function...
      GUID guid = operator GUID();
      OLECHAR buf[40] = { };
      ::StringFromGUID2(guid, buf, sizeof(buf));
      return wstring(buf);

   operator GUID () // ... and its "underload"
      GUID guid = { };
      return guid;

Points of Interest

This code was developed a long time ago as an answer to a friend's doubt. I learnt while coding that C++ is even more powerful than we think it is. In one form or another, we can always get what we want.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Wanderley Caloni
Software Developer (Senior) Intelitrader
Brazil Brazil
15 years experience in Windows operating systems developing in information security companies;
great team relationship; problem solving using systemic vision, knowledge bases maintenance,
chronograms and people coordination.

Technical historic
Software and hardware inventory
Clipboard and PrintScreen protection using windows hooks and global messages manipulation
Driver writing system event log
DeviceIoControl user/kernel communication
Desktop remote control using VNC technique
Remote execution tool PsExec (SysInternals) like
Print control using regex (Boost) and shell hook
Access policies management during user logon/logoff (register and hooks)
Datgabase migration CTree -> SQL (OLE classes)
Windows authentication using custom GINA and DCOM; Credential Provider (Vista)
CTree database synchronism using custom DCOM service
Bootable Linux CD with bash scripts and disk cryptography tools using C language
Hard disk encryption and PenDrive (USB) storage control
Blue Screen analysis using memory dumps and WinDbg live (Gflags)
System account execution using custom COM service
MBR (Master Boot Record) customization library
Blowfish/SHA-1 encryption library using C++ and 16 bits Assembly
Log access driver using shared memory between user and kernel mode
Kernel mode API hook for 9X and NT platforms
16 bits Assembly loader; debugging using tool
Executable protection using embedded domain authentication recorded inside files resources
Internet Explorer 6/7 and Firefox 1/2 browsing protection using Assembly 32 bits code injection
Code, strings and execution protection library (using Win32 interruptions)
Centralized log generation library using shared memory and global events
Internet Explorer 6/7 BHO (Broser Helper Object) and ActiveX; Mozilla/Firefox XPI plugin
Projects management using Source Safe, Bazaar and Batch (Win) scripts
Kernel mode debugging using SoftIce and WinDbg for NT

Comments and Discussions

SuggestionAlternative [modified] Pin
Pascal Damman16-Sep-11 2:49
memberPascal Damman16-Sep-11 2:49 
GeneralNice Article Pin
GuimaSun8-May-07 3:33
memberGuimaSun8-May-07 3:33 
GeneralRe: Nice Article Pin
Wanderley Caloni8-May-07 4:25
professionalWanderley Caloni8-May-07 4:25 
QuestionHow to Create member fcuntions like what u said? Pin
shtarwaterloo16-Apr-07 17:46
membershtarwaterloo16-Apr-07 17:46 
AnswerRe: How to Create member fcuntions like what u said? Pin
Wanderley Caloni17-Apr-07 3:34
professionalWanderley Caloni17-Apr-07 3:34 
GeneralRe: How to Create member fcuntions like what u said? Pin
shtarwaterloo24-Apr-07 15:43
membershtarwaterloo24-Apr-07 15:43 
GeneralRe: How to Create member fcuntions like what u said? Pin
sylvaticus7-Aug-07 1:35
membersylvaticus7-Aug-07 1:35 
GeneralRe: How to Create member fcuntions like what u said? Pin
Wanderley Caloni7-Aug-07 3:43
professionalWanderley Caloni7-Aug-07 3:43 
GeneralThanks Pin
neurorebel_6-Apr-07 2:33
memberneurorebel_6-Apr-07 2:33 
GeneralRe: Thanks Pin
Wanderley Caloni6-Apr-07 5:38
professionalWanderley Caloni6-Apr-07 5:38 
GeneralRe: Thanks Pin
Elias Bachaalany9-Apr-07 21:45
memberElias Bachaalany9-Apr-07 21:45 
GeneralRe: Thanks Pin
Wanderley Caloni10-Apr-07 2:31
professionalWanderley Caloni10-Apr-07 2:31 
QuestionDoes Second approach work? Pin
Chenna A Reddy5-Apr-07 19:30
memberChenna A Reddy5-Apr-07 19:30 
AnswerRe: Does Second approach work? Pin
Wanderley Caloni5-Apr-07 22:52
professionalWanderley Caloni5-Apr-07 22:52 
GeneralTry Compiling it with GCC Pin
etkid845-Apr-07 5:15
memberetkid845-Apr-07 5:15 
GeneralRe: Try Compiling it with GCC Pin
Wanderley Caloni5-Apr-07 7:19
professionalWanderley Caloni5-Apr-07 7:19 
QuestionTemplate functions ? Pin
chatulevich4-Apr-07 1:51
memberchatulevich4-Apr-07 1:51 
AnswerRe: Template functions ? Pin
Wanderley Caloni4-Apr-07 2:46
professionalWanderley Caloni4-Apr-07 2:46 
GeneralRe: Template functions ? Pin
chatulevich4-Apr-07 3:03
memberchatulevich4-Apr-07 3:03 
GeneralGreat! Pin
Michael272-Apr-07 21:50
memberMichael272-Apr-07 21:50 
GeneralRe: Great! Pin
Wanderley Caloni3-Apr-07 3:24
professionalWanderley Caloni3-Apr-07 3:24 
GeneralMisuse of Conversion Operators [modified] Pin
George L. Jackson2-Apr-07 13:07
memberGeorge L. Jackson2-Apr-07 13:07 
GeneralRe: Misuse of Conversion Operators Pin
ETA2-Apr-07 21:55
memberETA2-Apr-07 21:55 
GeneralRe: Misuse of Conversion Operators Pin
George L. Jackson2-Apr-07 23:54
memberGeorge L. Jackson2-Apr-07 23:54 
GeneralRe: Misuse of Conversion Operators Pin
*bilk*3-Apr-07 2:09
member*bilk*3-Apr-07 2:09 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Posted 30 Mar 2007


29 bookmarked