> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# gpudb::FilterByStringRequest

> gpudb::FilterByStringRequest — Kinetica C++ API

<div className="kinetica-doxygen">
  <div className="contents">
    <p>A set of parameters for <a className="el" href="/content/api/cpp/classgpudb_1_1GPUdb#a4c7a7acb22b8793a57a5c9162f7e063e">GPUdb::filterByString</a>. <a href="#details">More...</a></p>
    <p><code>#include \<<a className="el" href="/content/api/cpp/filter__by__string_8h_source">gpudb/protocol/filter\_by\_string.h</a>></code></p>

    <table className="memberdecls">
      <tr className="heading">
        <td colSpan="2">
          <h2 className="groupheader"> Public Member Functions</h2>
        </td>
      </tr>

      <tr className="memitem:a64f635e4d69b668fbc9197134c70b0cd" id="r_a64f635e4d69b668fbc9197134c70b0cd">
        <td className="memItemLeft" align="right" valign="top"> </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#a64f635e4d69b668fbc9197134c70b0cd">FilterByStringRequest</a> ()</td>
      </tr>

      <tr className="memdesc:a64f635e4d69b668fbc9197134c70b0cd">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">Constructs a <a className="el" href="/content/api/cpp/structgpudb_1_1FilterByStringRequest" title="A set of parameters for GPUdb::filterByString.">FilterByStringRequest</a> object with default parameters. <br /></td>
      </tr>

      <tr className="separator:a64f635e4d69b668fbc9197134c70b0cd">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>

      <tr className="memitem:a4de74bf8f0f2ced82c242fd0038d44b6" id="r_a4de74bf8f0f2ced82c242fd0038d44b6">
        <td className="memItemLeft" align="right" valign="top"> </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#a4de74bf8f0f2ced82c242fd0038d44b6">FilterByStringRequest</a> (const std::string \&tableName\_, const std::string \&viewName\_, const std::string \&expression\_, const std::string \&mode\_, const std::vector\< std::string > \&columnNames\_, const std::map\< std::string, std::string > \&options\_)</td>
      </tr>

      <tr className="memdesc:a4de74bf8f0f2ced82c242fd0038d44b6">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">Constructs a <a className="el" href="/content/api/cpp/structgpudb_1_1FilterByStringRequest" title="A set of parameters for GPUdb::filterByString.">FilterByStringRequest</a> object with the specified parameters. <br /></td>
      </tr>

      <tr className="separator:a4de74bf8f0f2ced82c242fd0038d44b6">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>
    </table>

    <table className="memberdecls">
      <tr className="heading">
        <td colSpan="2">
          <h2 className="groupheader"> Public Attributes</h2>
        </td>
      </tr>

      <tr className="memitem:a2ecb4bb206c55c5c2daacfffef7a5302" id="r_a2ecb4bb206c55c5c2daacfffef7a5302">
        <td className="memItemLeft" align="right" valign="top">std::string </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#a2ecb4bb206c55c5c2daacfffef7a5302">tableName</a></td>
      </tr>

      <tr className="memdesc:a2ecb4bb206c55c5c2daacfffef7a5302">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">Name of the table on which the filter operation will be performed, in \[ schema\_name. ]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>. <br /></td>
      </tr>

      <tr className="separator:a2ecb4bb206c55c5c2daacfffef7a5302">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>

      <tr className="memitem:a4621c16897c279d70c9f78e216bd613f" id="r_a4621c16897c279d70c9f78e216bd613f">
        <td className="memItemLeft" align="right" valign="top">std::string </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#a4621c16897c279d70c9f78e216bd613f">viewName</a></td>
      </tr>

      <tr className="memdesc:a4621c16897c279d70c9f78e216bd613f">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">If provided, then this will be the name of the view containing the results, in \[ schema\_name. ]view\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a> and meeting <a href="/content/concepts/tables/#table-naming-criteria" target="_top">table naming criteria</a>. <br /></td>
      </tr>

      <tr className="separator:a4621c16897c279d70c9f78e216bd613f">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>

      <tr className="memitem:a90c606e68e2d75d14eb446944442c8a6" id="r_a90c606e68e2d75d14eb446944442c8a6">
        <td className="memItemLeft" align="right" valign="top">std::string </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#a90c606e68e2d75d14eb446944442c8a6">expression</a></td>
      </tr>

      <tr className="memdesc:a90c606e68e2d75d14eb446944442c8a6">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">The expression with which to filter the table. <br /></td>
      </tr>

      <tr className="separator:a90c606e68e2d75d14eb446944442c8a6">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>

      <tr className="memitem:aad8e174b940195c84e9e96bbc18e047d" id="r_aad8e174b940195c84e9e96bbc18e047d">
        <td className="memItemLeft" align="right" valign="top">std::string </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#aad8e174b940195c84e9e96bbc18e047d">mode</a></td>
      </tr>

      <tr className="memdesc:aad8e174b940195c84e9e96bbc18e047d">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">The string filtering mode to apply. <br /></td>
      </tr>

      <tr className="separator:aad8e174b940195c84e9e96bbc18e047d">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>

      <tr className="memitem:ab53badf7ed7e758d129c0e6c83a9851a" id="r_ab53badf7ed7e758d129c0e6c83a9851a">
        <td className="memItemLeft" align="right" valign="top">std::vector\< std::string > </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#ab53badf7ed7e758d129c0e6c83a9851a">columnNames</a></td>
      </tr>

      <tr className="memdesc:ab53badf7ed7e758d129c0e6c83a9851a">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">List of columns on which to apply the filter. <br /></td>
      </tr>

      <tr className="separator:ab53badf7ed7e758d129c0e6c83a9851a">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>

      <tr className="memitem:a18d6a72e8b8ec5fd8a873b851ba4e442" id="r_a18d6a72e8b8ec5fd8a873b851ba4e442">
        <td className="memItemLeft" align="right" valign="top">std::map\< std::string, std::string > </td>
        <td className="memItemRight" valign="bottom"><a className="el" href="#a18d6a72e8b8ec5fd8a873b851ba4e442">options</a></td>
      </tr>

      <tr className="memdesc:a18d6a72e8b8ec5fd8a873b851ba4e442">
        <td className="mdescLeft"> </td>
        <td className="mdescRight">Optional parameters. <br /></td>
      </tr>

      <tr className="separator:a18d6a72e8b8ec5fd8a873b851ba4e442">
        <td className="memSeparator" colSpan="2"> </td>
      </tr>
    </table>

    <h2 className="groupheader">Detailed Description</h2>

    <div className="textblock">
      <p>A set of parameters for <a className="el" href="/content/api/cpp/classgpudb_1_1GPUdb#a4c7a7acb22b8793a57a5c9162f7e063e">GPUdb::filterByString</a>. </p>
      <p>Calculates which objects from a table or view match a string expression for the given string columns. Setting <a className="el" href="/content/api/cpp/namespacegpudb#a03974abe744afd69b0a93a332c3c06a0">case\_sensitive</a> can modify case sensitivity in matching for all modes except <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">search</a>. For <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">search</a> mode details and limitations, see <a href="/content/concepts/full_text_search/" target="_top">Full Text Search</a>. </p>
      <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00025">25</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
    </div>

    <h2 className="groupheader">Constructor & Destructor Documentation</h2>
    <h2 className="memtitle"><span className="permalink"><a href="#a64f635e4d69b668fbc9197134c70b0cd">◆ </a></span>FilterByStringRequest() <span className="overload">\[1/2]</span></h2>

    <div className="memitem">
      <div className="memproto">
        <table className="mlabels">
          <tr>
            <td className="mlabels-left">
              <table className="memname">
                <tr>
                  <td className="memname">gpudb::FilterByStringRequest::FilterByStringRequest </td>
                  <td>(</td>

                  <td className="paramname">
                    <span className="paramname">
                      <span className="em" />
                    </span>
                  </td>

                  <td>)</td>

                  <td />
                </tr>
              </table>
            </td>

            <td className="mlabels-right"> <span className="mlabels"><span className="mlabel inline">inline</span></span> </td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>Constructs a <a className="el" href="/content/api/cpp/structgpudb_1_1FilterByStringRequest" title="A set of parameters for GPUdb::filterByString.">FilterByStringRequest</a> object with default parameters. </p>
        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00030">30</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="memtitle"><span className="permalink"><a href="#a4de74bf8f0f2ced82c242fd0038d44b6">◆ </a></span>FilterByStringRequest() <span className="overload">\[2/2]</span></h2>

    <div className="memitem">
      <div className="memproto">
        <table className="mlabels">
          <tr>
            <td className="mlabels-left">
              <table className="memname">
                <tr>
                  <td className="memname">gpudb::FilterByStringRequest::FilterByStringRequest </td>
                  <td>(</td>
                  <td className="paramtype">const std::string &</td>
                  <td className="paramname"><span className="paramname"><span className="em">tableName\_</span></span>, </td>
                </tr>

                <tr>
                  <td className="paramkey" />

                  <td />

                  <td className="paramtype">const std::string &</td>
                  <td className="paramname"><span className="paramname"><span className="em">viewName\_</span></span>, </td>
                </tr>

                <tr>
                  <td className="paramkey" />

                  <td />

                  <td className="paramtype">const std::string &</td>
                  <td className="paramname"><span className="paramname"><span className="em">expression\_</span></span>, </td>
                </tr>

                <tr>
                  <td className="paramkey" />

                  <td />

                  <td className="paramtype">const std::string &</td>
                  <td className="paramname"><span className="paramname"><span className="em">mode\_</span></span>, </td>
                </tr>

                <tr>
                  <td className="paramkey" />

                  <td />

                  <td className="paramtype">const std::vector\< std::string > &</td>
                  <td className="paramname"><span className="paramname"><span className="em">columnNames\_</span></span>, </td>
                </tr>

                <tr>
                  <td className="paramkey" />

                  <td />

                  <td className="paramtype">const std::map\< std::string, std::string > &</td>
                  <td className="paramname"><span className="paramname"><span className="em">options\_</span></span> )</td>
                </tr>
              </table>
            </td>

            <td className="mlabels-right"> <span className="mlabels"><span className="mlabel inline">inline</span></span> </td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>Constructs a <a className="el" href="/content/api/cpp/structgpudb_1_1FilterByStringRequest" title="A set of parameters for GPUdb::filterByString.">FilterByStringRequest</a> object with the specified parameters. </p>

        <div className="dl params">
          <div className="dt">Parameters</div>

          <div className="dd">
            <table className="params">
              <tr>
                <td className="paramdir">\[in]</td>
                <td className="paramname">tableName\_</td>
                <td>Name of the table on which the filter operation will be performed, in \[schema\_name.]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>. Must be an existing table or view. </td>
              </tr>

              <tr>
                <td className="paramdir">\[in]</td>
                <td className="paramname">viewName\_</td>
                <td>If provided, then this will be the name of the view containing the results, in \[schema\_name.]view\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a> and meeting <a href="/content/concepts/tables/#table-naming-criteria" target="_top">table naming criteria</a>. Must not be an already existing table or view. The default value is ''. </td>
              </tr>

              <tr>
                <td className="paramdir">\[in]</td>
                <td className="paramname">expression\_</td>
                <td>The expression with which to filter the table. </td>
              </tr>

              <tr>
                <td className="paramdir">\[in]</td>
                <td className="paramname">mode\_</td>

                <td>
                  The string filtering mode to apply. See below for details. Supported values:

                  <ul>
                    <li> <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">filter\_by\_string\_search</a>: Full text search query with wildcards and boolean operators. Note that for this mode, no column can be specified in <span className="em arg">columnNames\_</span>; all string columns of the table that have text search enabled will be searched. </li>
                    <li> <a className="el" href="/content/api/cpp/namespacegpudb#a23c0c11ad0967c707d790d64e71e20af">filter\_by\_string\_equals</a>: Exact whole-string match (accelerated). </li>
                    <li> <a className="el" href="/content/api/cpp/namespacegpudb#af8dfaafd43b3cb9dbca90fc60f3667ba">filter\_by\_string\_contains</a>: Partial substring match (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0. </li>
                    <li> <a className="el" href="/content/api/cpp/namespacegpudb#a04336e34ac48efe030a77e76e5eddbd4">filter\_by\_string\_starts\_with</a>: Strings that start with the given expression (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0. </li>
                    <li> <a className="el" href="/content/api/cpp/namespacegpudb#afe5b76dc543d431780210b16e600746d">filter\_by\_string\_regex</a>: Full regular expression search (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0. </li>
                  </ul>
                </td>
              </tr>

              <tr>
                <td className="paramdir">\[in]</td>
                <td className="paramname">columnNames\_</td>
                <td>List of columns on which to apply the filter. Ignored for <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">search</a> mode. </td>
              </tr>

              <tr>
                <td className="paramdir">\[in]</td>
                <td className="paramname">options\_</td>

                <td>
                  Optional parameters.

                  <ul>
                    <li>
                      <a className="el" href="/content/api/cpp/namespacegpudb#a5ab071ec4ac6b35cdf6abe4b3ee59ce0">filter\_by\_string\_create\_temp\_table</a>: If <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">true</a>, a unique temporary table name will be generated in the sys\_temp schema and used in place of <span className="em arg">viewName\_</span>. This is always allowed even if the caller does not have permission to create tables. The generated name is returned in <a className="el" href="/content/api/cpp/namespacegpudb#aadd6c9450b2af70fc3a835c9be725e60">qualified\_view\_name</a>. Supported values:

                      <ul>
                        <li> <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">filter\_by\_string\_true</a> </li>
                        <li> <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">filter\_by\_string\_false</a> </li>
                      </ul>

                      The default value is <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">filter\_by\_string\_false</a>.
                    </li>

                    <li> <a className="el" href="/content/api/cpp/namespacegpudb#a11440f1ad8db563a96ddd47a7a1d9c33">filter\_by\_string\_collection\_name</a>: \[DEPRECATED–please specify the containing schema for the view as part of <span className="em arg">viewName\_</span> and use <a className="el" href="/content/api/cpp/classgpudb_1_1GPUdb#a4aa5990ebebfab30b5961654f546cfd0">GPUdb::createSchema</a> to create the schema if non-existent] Name of a schema for the newly created view. If the schema is non-existent, it will be automatically created. </li>

                    <li>
                      <a className="el" href="/content/api/cpp/namespacegpudb#a03974abe744afd69b0a93a332c3c06a0">filter\_by\_string\_case\_sensitive</a>: If <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">false</a> then string filtering will ignore case. Does not apply to <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">search</a> mode. Supported values:

                      <ul>
                        <li> <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">filter\_by\_string\_true</a> </li>
                        <li> <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">filter\_by\_string\_false</a> </li>
                      </ul>

                      The default value is <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">filter\_by\_string\_true</a>.
                    </li>
                  </ul>

                  The default value is an empty map.
                </td>
              </tr>
            </table>
          </div>
        </div>

        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00164">164</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="groupheader">Member Data Documentation</h2>
    <h2 className="memtitle"><span className="permalink"><a href="#ab53badf7ed7e758d129c0e6c83a9851a">◆ </a></span>columnNames</h2>

    <div className="memitem">
      <div className="memproto">
        <table className="memname">
          <tr>
            <td className="memname">std::vector\<std::string> gpudb::FilterByStringRequest::columnNames</td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>List of columns on which to apply the filter. </p>
        <p>Ignored for <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">search</a> mode. </p>
        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00233">233</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="memtitle"><span className="permalink"><a href="#a90c606e68e2d75d14eb446944442c8a6">◆ </a></span>expression</h2>

    <div className="memitem">
      <div className="memproto">
        <table className="memname">
          <tr>
            <td className="memname">std::string gpudb::FilterByStringRequest::expression</td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>The expression with which to filter the table. </p>
        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00197">197</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="memtitle"><span className="permalink"><a href="#aad8e174b940195c84e9e96bbc18e047d">◆ </a></span>mode</h2>

    <div className="memitem">
      <div className="memproto">
        <table className="memname">
          <tr>
            <td className="memname">std::string gpudb::FilterByStringRequest::mode</td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>The string filtering mode to apply. </p>
        <p>See below for details. Supported values: </p>

        <ul>
          <li> <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">filter\_by\_string\_search</a>: Full text search query with wildcards and boolean operators. Note that for this mode, no column can be specified in <a className="el" href="#ab53badf7ed7e758d129c0e6c83a9851a">columnNames</a>; all string columns of the table that have text search enabled will be searched. </li>
          <li> <a className="el" href="/content/api/cpp/namespacegpudb#a23c0c11ad0967c707d790d64e71e20af">filter\_by\_string\_equals</a>: Exact whole-string match (accelerated). </li>
          <li> <a className="el" href="/content/api/cpp/namespacegpudb#af8dfaafd43b3cb9dbca90fc60f3667ba">filter\_by\_string\_contains</a>: Partial substring match (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0. </li>
          <li> <a className="el" href="/content/api/cpp/namespacegpudb#a04336e34ac48efe030a77e76e5eddbd4">filter\_by\_string\_starts\_with</a>: Strings that start with the given expression (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0. </li>
          <li> <a className="el" href="/content/api/cpp/namespacegpudb#afe5b76dc543d431780210b16e600746d">filter\_by\_string\_regex</a>: Full regular expression search (not accelerated). If the column is a string type (non-charN) and the number of records is too large, it will return 0. </li>
        </ul>

        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00227">227</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="memtitle"><span className="permalink"><a href="#a18d6a72e8b8ec5fd8a873b851ba4e442">◆ </a></span>options</h2>

    <div className="memitem">
      <div className="memproto">
        <table className="memname">
          <tr>
            <td className="memname">std::map\<std::string, std::string> gpudb::FilterByStringRequest::options</td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>Optional parameters. </p>

        <ul>
          <li>
            <a className="el" href="/content/api/cpp/namespacegpudb#a5ab071ec4ac6b35cdf6abe4b3ee59ce0">filter\_by\_string\_create\_temp\_table</a>: If <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">true</a>, a unique temporary table name will be generated in the sys\_temp schema and used in place of <a className="el" href="#a4621c16897c279d70c9f78e216bd613f">viewName</a>. This is always allowed even if the caller does not have permission to create tables. The generated name is returned in <a className="el" href="/content/api/cpp/namespacegpudb#aadd6c9450b2af70fc3a835c9be725e60">qualified\_view\_name</a>. Supported values:

            <ul>
              <li> <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">filter\_by\_string\_true</a> </li>
              <li> <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">filter\_by\_string\_false</a> </li>
            </ul>

            The default value is <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">filter\_by\_string\_false</a>.
          </li>

          <li> <a className="el" href="/content/api/cpp/namespacegpudb#a11440f1ad8db563a96ddd47a7a1d9c33">filter\_by\_string\_collection\_name</a>: \[DEPRECATED–please specify the containing schema for the view as part of <a className="el" href="#a4621c16897c279d70c9f78e216bd613f">viewName</a> and use <a className="el" href="/content/api/cpp/classgpudb_1_1GPUdb#a4aa5990ebebfab30b5961654f546cfd0">GPUdb::createSchema</a> to create the schema if non-existent] Name of a schema for the newly created view. If the schema is non-existent, it will be automatically created. </li>

          <li>
            <a className="el" href="/content/api/cpp/namespacegpudb#a03974abe744afd69b0a93a332c3c06a0">filter\_by\_string\_case\_sensitive</a>: If <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">false</a> then string filtering will ignore case. Does not apply to <a className="el" href="/content/api/cpp/namespacegpudb#a344e39d3272af6d6cd26efd95370abe1">search</a> mode. Supported values:

            <ul>
              <li> <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">filter\_by\_string\_true</a> </li>
              <li> <a className="el" href="/content/api/cpp/namespacegpudb#a7f21e1256d545666c9face38129ff449">filter\_by\_string\_false</a> </li>
            </ul>

            The default value is <a className="el" href="/content/api/cpp/namespacegpudb#af3080edf9fd7312c560898325f468a2e">filter\_by\_string\_true</a>.
          </li>
        </ul>

        <p>The default value is an empty map. </p>
        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00281">281</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="memtitle"><span className="permalink"><a href="#a2ecb4bb206c55c5c2daacfffef7a5302">◆ </a></span>tableName</h2>

    <div className="memitem">
      <div className="memproto">
        <table className="memname">
          <tr>
            <td className="memname">std::string gpudb::FilterByStringRequest::tableName</td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>Name of the table on which the filter operation will be performed, in \[ schema\_name. ]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>. </p>
        <p>Must be an existing table or view. </p>
        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00181">181</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <h2 className="memtitle"><span className="permalink"><a href="#a4621c16897c279d70c9f78e216bd613f">◆ </a></span>viewName</h2>

    <div className="memitem">
      <div className="memproto">
        <table className="memname">
          <tr>
            <td className="memname">std::string gpudb::FilterByStringRequest::viewName</td>
          </tr>
        </table>
      </div>

      <div className="memdoc">
        <p>If provided, then this will be the name of the view containing the results, in \[ schema\_name. ]view\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a> and meeting <a href="/content/concepts/tables/#table-naming-criteria" target="_top">table naming criteria</a>. </p>
        <p>Must not be an already existing table or view. The default value is ''. </p>
        <p className="definition">Definition at line <a className="el" href="/content/api/cpp/filter__by__string_8h_source#l00192">192</a> of file <a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a>.</p>
      </div>
    </div>

    <hr />

    The documentation for this struct was generated from the following file:

    <ul>
      <li>gpudb/protocol/<a className="el" href="/content/api/cpp/filter__by__string_8h_source">filter\_by\_string.h</a></li>
    </ul>
  </div>
</div>