1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7    <title>AllocateAndCopyString</title>
8  </head>
9  <body>
10    <h1><CODE><a href="../../nw/Overview.html">nw</a>::<a href="../../nw/os/Overview.html">os</a>::AllocateAndCopyString</CODE> Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14template &lt;typename TChar&gt;
15TChar * AllocateAndCopyString(
16     const TChar * str,
17     <a href="../../nw/os/IAllocator/Overview.html">os::IAllocator</a> * allocator,
18     size_t maxSize
19);
20</pre>
21    </div>
22    <h2>Template Arguments</h2>
23    <div class="section">
24      <table class="arguments">
25        <thead>
26          <tr>
27            <th>Name</th>
28            <td>Description</td>
29          </tr>
30        </thead>
31        <tr>
32          <th>TChar</th>
33          <td>Character type.</td>
34        </tr> </table>
35    </div>
36    <h2>Arguments</h2>
37    <div class="section">
38      <table class="arguments">
39        <thead>
40          <tr>
41            <td width="15" />
42            <th>Name</th>
43            <td>Description</td>
44          </tr>
45        </thead>
46        <tr>
47          <td>in</td>
48          <th>str</th>
49          <td>String to copy.</td>
50        </tr>
51        <tr>
52          <td>in</td>
53          <th>allocator</th>
54          <td>Memory allocator.</td>
55        </tr>
56        <tr>
57          <td>in</td>
58          <th>maxSize</th>
59          <td>Maximum number of characters to use as a limit during copies.</td>
60        </tr> </table>
61    </div>
62    <h2>Return Values</h2>
63    <div class="section">Returns the copied string. </div>
64    <h2>Description</h2>
65    <div class="section">
66      <p>Allocates only the required amount of memory, and copies a string into the allocated region.</p>
67    </div>
68  <hr><p>CONFIDENTIAL</p></body>
69</html>
70