Method EncodeURICharacters

PathCopyCopy/src/StringUtils.cpp:116–165

Encodes characters in the given string that are invalid in an URI in percent-encoding (e.g., %20 for space, etc.) @param p_rString String whose characters to encode. Upon return, will contain the string with encoded characters. @param p_EncodeParam What characters to encode.

// @param p_EncodeParam What characters to encode.
//
void StringUtils::EncodeURICharacters(std::wstring& p_rString,
                                      const EncodeParam p_EncodeParam)
{
    // The characters identified as "invalid" by this method were chosen
    // based on the information found in the following StackOverflow thread:
    //
    // http://stackoverflow.com/questions/1547899/which-characters-make-a-url-invalid/13500078#13500078
    //
    // This has been suggested in the Feature request that led to this code:
    //
    // https://pathcopycopy.codeplex.com/workitem/11374

    if (p_EncodeParam != EncodeParam::None) {
        // Choose function to identify characters to encode.
        std::function<bool(wchar_t)> identifyFunc;
        switch (p_EncodeParam) {
            case EncodeParam::Whitespace: {
                identifyFunc = [](const wchar_t p_Char) {
                    const unsigned int val = static_cast<unsigned int>(p_Char);
                    return val <= 0x1F || val == 0x20 || val == 0x7F;
                };
                break;
            }
            case EncodeParam::All: {
                identifyFunc = [](const wchar_t p_Char) {
                    const unsigned int val = static_cast<unsigned int>(p_Char);
                    return val <= 0x1F || val == 0x20 || val == 0x7F || p_Char == L'<' || p_Char == L'>' ||
                        p_Char == L'#' || p_Char == L'%' || p_Char == L'"' || p_Char == L'{' ||
                        p_Char == L'}' || p_Char == L'|' || p_Char == L'\\' || p_Char == L'^' ||
                        p_Char == L'[' || p_Char == L']' || p_Char == L'`' || p_Char == L'+';
                };
                break;
            }
            default:
                assert(false);
        }

        std::wstringstream wss;
        wss << std::hex;
        for (std::wstring::const_iterator it = p_rString.cbegin(); it != p_rString.cend(); ++it) {
            const wchar_t curChar = *it;
            if (identifyFunc(curChar)) {
                wss << L"%" << static_cast<unsigned int>(curChar);
            } else {
                wss << curChar;
            }
        }
        p_rString = wss.str();
    }
}