Namespaces
Variants

    cpp/string/wide/wcscat: Difference between revisions

    From cppreference.com
    ← Older edit
    P12bot (talk | contribs)
    Bots
    111,718 edits
    m Text replace - "cpp/string/narrow/dcl" to "cpp/string/wide/dcl"
    Space Mission (talk | contribs)
    19,914 edits
    m →top: " *" → "* "
     
    (11 intermediate revisions by 4 users not shown)
    Line 1: Line 1:
    {{cpp/title| wcscat}}
    {{cpp/title| wcscat}}
    {{cpp/string/wide/sidebar}}
    {{cpp/string/wide/}}
    {{ddcl | header=cstring |
    {{ddcl|header=|
    char *strcat( char *dest, const char *src );
    * ( * dest, const * src );
    }}
    }}


    Appends a character string pointed to by {{tt|src}} to a character string pointed to by {{tt|dest}}. The resulting character string is null-terminated. If the strings overlap, the behavior is undefined.  
    Appends a string pointed to by {{|src}} to string pointed to by {{|dest}}. The resulting string is null-terminated.
     
    the the
     
    behavior is undefined .  


    ===Parameters===
    ===Parameters===
    {{param list begin}}
    {{begin}}
    {{param list item | dest | pointer to the null-terminated character string to append to}}
    {{|dest|pointer to the null-terminated string to append to}}
    {{param list item | src | pointer to the null-terminated character string to copy from}}
    {{|src|pointer to the null-terminated string to copy from}}
    {{param list end}}
    {{end}}


    ===Return value===
    ===Return value===


    {{tt|dest}}
    {{
    |


    ===Example===
    {{example cpp
    |
    =
    | code=
    | output=
    |=
    |output=
    }}
    }}


    ===See also===
    ===See also===
    {{dcl list begin}}
    {{begin}}
    {{dcl list template | cpp/string/wide/dcl list wcsncat}}
    {{|cpp/string/wide/wcsncat}}
    {{dcl list template | cpp/string/wide/dcl list wcscpy}}
    {{
    {{dcl list end}}
    |cpp/string/wide/wcscpy}}
    {{
    end
     
    }}

    Latest revision as of 21:28, 18 June 2023

     
    C++
     
    Text processing library
     
    Null-terminated wide strings
     
    Defined in header <cwchar> 
    wchar_t* wcscat( wchar_t* dest, const wchar_t* src );

    Appends a copy of the wide string pointed to by src to the end of the wide string pointed to by dest. The wide character src[0] replaces the null terminator at the end of dest. The resulting wide string is null-terminated.

    The behavior is undefined if the destination array is not large enough for the contents of both src and dest and the terminating null wide character.

    The behavior is undefined if the strings overlap.

    Parameters

    dest - pointer to the null-terminated wide string to append to
    src - pointer to the null-terminated wide string to copy from

    Return value

    Returns a copy of dest.

    Example

    Run this code
    #include <clocale>
#include <cwchar> 
#include <iostream>

int main(void) 
{
    wchar_t str[50] = L"Земля, прощай.";
    std::wcscat(str, L" ");
    std::wcscat(str, L"В добрый путь.");
    
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    std::wcout << str << '\n';
}

    Possible output: 

    Земля, прощай. В добрый путь.

    See also

    		 appends a certain amount of wide characters from one wide string to another
    (function) [edit]
    		concatenates two strings
    (function) [edit]
    		copies one wide string to another
    (function) [edit]
    C documentation for wcscat