| Server IP : 121.121.20.254 / Your IP : 216.73.216.202 Web Server : Microsoft-IIS/10.0 System : Windows NT WEB-SERVER 10.0 build 20348 (Windows Server 2022) AMD64 User : IUSR ( 0) PHP Version : 8.3.28 Disable Function : NONE MySQL : ON | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /Program Files/LibreOffice/help/en-US/text/sbasic/shared/ |
Upload File : |
<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<base href="../../../../">
<noscript><meta http-equiv="refresh" content="0; URL=../../../../en-US/noscript.html"></noscript>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>StrConv Function [VBA]</title>
<link rel="shortcut icon" href="media/navigation/favicon.ico">
<link type="text/css" href="normalize.css" rel="Stylesheet">
<link type="text/css" href="prism.css" rel="Stylesheet">
<link type="text/css" href="default.css" rel="Stylesheet">
<script type="text/javascript" src="polyfills.js"></script><script type="text/javascript" src="languages.js"></script><script type="text/javascript" src="en-US/langnames.js"></script><script type="text/javascript" src="flexsearch.debug.js"></script><script type="text/javascript" src="prism.js"></script><script type="text/javascript" src="help2.js" defer></script><script type="text/javascript" src="a11y-toggle.js" defer></script><script type="text/javascript" src="paginathing.js" defer></script><script type="text/javascript" src="en-US/bookmarks.js" defer></script><script type="text/javascript" src="en-US/contents.js" defer></script><script type="text/javascript" src="help.js" defer></script><meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body>
<header id="TopLeftHeader"><a class="symbol" href="en-US/text/shared/05/new_help.html"><div></div></a><a class="logo" href="en-US/text/shared/05/new_help.html"><p dir="auto">LibreOffice 24.2 Help</p></a><div class="dropdowns"><div class="modules">
<button type="button" data-a11y-toggle="modules-nav" id="modules" aria-haspopup="true" aria-expanded="false" aria-controls="modules-nav">Module</button><nav id="modules-nav" hidden=""></nav>
</div></div></header><aside class="leftside"><input id="accordion-1" name="accordion-menu" type="checkbox"><label for="accordion-1" dir="auto">Contents</label><div id="Contents" class="contents-treeview"></div></aside><div id="SearchFrame"><div id="Bookmarks">
<input id="search-bar" type="search" class="search" placeholder="Search in bookmarks for chosen module" dir="auto"><div class="nav-container" tabindex="0"><nav class="index" dir="auto"></nav></div>
</div></div>
<div id="DisplayArea" itemprop="softwareHelp" itemscope="true" itemtype="http://schema.org/SoftwareApplication">
<a name="bm_id941622761814292"></a>
<meta itemprop="keywords" content="StrConv function">
<a name="vbastrconv"></a>
<h1 id="hd_id791622761498015" dir="auto">StrConv Function</h1>
<p id="par_id621622761498018" class="paragraph" dir="auto"><a name="variable%20name"></a>Convert a string as specified by a conversion type.</p>
<div class="embedded">
<a name="vbasupport"></a>
<div class="warning">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/warning.svg" alt="warning" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id051920171018124524" dir="auto">This constant, function or object is enabled with the statement <a target="_top" href="en-US/text/sbasic/shared/03103350.html"><span class="literal">Option VBASupport 1</span></a> placed before the executable program code in a module.</p></div>
</div>
<br>
</div>
<div class="embedded">
<a name="functsyntax"></a>
<h3 id="hd_id061420171139089682" dir="auto">Syntax:</h3>
</div>
<p id="par_id771622762489917" class="code" dir="auto">StrConv(string As String, Conversion As Integer, [ LCID ])</p>
<div class="embedded">
<a name="functvalue"></a>
<h3 id="hd_id061420171139087480" dir="auto">Return value:</h3>
</div>
<p id="par_id971548420129767" class="paragraph" dir="auto">String</p>
<div class="embedded">
<a name="functparameters"></a>
<h3 id="hd_id061420171139084157" dir="auto">Parameters:</h3>
</div>
<p id="par_id421622762822934" class="paragraph" dir="auto"><span class="emph">string</span>: Any valid string expression.</p>
<p id="par_id671622762931475" class="paragraph" dir="auto"><span class="emph">Conversion</span>: The type of conversion to perform, as defined in the table below.</p>
<a name="StrConv_constants"></a>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id531622763145456" class="tableheadintable" dir="auto">Conversion</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id131622763145457" class="tableheadintable" dir="auto">Value</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id411622763145457" class="tableheadintable" dir="auto">Description</p>
</th>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id721622763145457" class="tablecontentintable" dir="auto">vbUpperCase</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id11622763145458" class="tablecontentintable" dir="auto">1</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id421622763145458" class="tablecontentintable" dir="auto">Converts <span class="emph">Text</span> characters to uppercase.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id91622763415122" class="tablecontentintable" dir="auto">vbLowerCase</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id911622763415123" class="tablecontentintable" dir="auto">2</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id251622763427976" class="tablecontentintable" dir="auto">Converts <span class="emph">Text</span> characters lowercase.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id1001622764064614" class="tablecontentintable" dir="auto">vbProperCase</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id21622764064614" class="tablecontentintable" dir="auto">3</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id531622764070154" class="tablecontentintable" dir="auto">Converts the first letter of every word in <span class="emph">Text</span> to uppercase.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id891622764187452" class="tablecontentintable" dir="auto">vbWide</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id471622764187452" class="tablecontentintable" dir="auto">4</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id881622764192628" class="tablecontentintable" dir="auto">Converts narrow (<a target="_top" href="en-US/text/shared/00/00000005.html#halfwidth">half-width</a>) characters in <span class="emph">Text</span> to wide (<a target="_top" href="en-US/text/shared/00/00000005.html#halfwidth">full-width</a>) characters.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id121622764454098" class="tablecontentintable" dir="auto">vbNarrow</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id31622764454099" class="tablecontentintable" dir="auto">8</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id71622764459352" class="paragraphintable" dir="auto">Converts wide (<a target="_top" href="en-US/text/shared/00/00000005.html#halfwidth">full-width</a>) characters in <span class="emph">Text</span> to narrow (<a target="_top" href="en-US/text/shared/00/00000005.html#halfwidth">half-width</a>) characters.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id801622764558261" class="tablecontentintable" dir="auto">vbKatakana</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id531622764558262" class="tablecontentintable" dir="auto">16</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id371622764565366" class="tablecontentintable" dir="auto">Converts Hiragana characters in <span class="emph">Text</span> to Katakana characters.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id771622764721149" class="tablecontentintable" dir="auto">vbHiragana</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id901622764721150" class="tablecontentintable" dir="auto">32</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id911622764728794" class="tablecontentintable" dir="auto">Converts Katakana characters in <span class="emph">Text</span> to Hiragana characters.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id211622764833771" class="tablecontentintable" dir="auto">vbUnicode</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id321622764833772" class="tablecontentintable" dir="auto">64</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id21622764841321" class="tablecontentintable" dir="auto">Converts <span class="emph">Text</span> characters to Unicode characters using the default code page of the system.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id901622764984846" class="tablecontentintable" dir="auto">vbFromUnicode</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id281622764984846" class="tablecontentintable" dir="auto">128</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id221622764991492" class="tablecontentintable" dir="auto">Converts <span class="emph">Text</span> characters from Unicode to the default code page of the system.</p>
</td>
</tr>
</table>
<br>
<p id="par_id761622765118156" class="paragraph" dir="auto"><span class="emph">LCID</span> Optional. The Locale ID in decimal number. If this parameter is omitted, it assumes the system Locale ID. Refer to the file <a target="_blank" href="https://opengrok.libreoffice.org/xref/core/l10ntools/source/ulfconv/msi-encodinglist.txt">msi-encodinglist.txt</a> for the available LCID values.</p>
<div class="embedded">
<a name="functexample"></a>
<h3 id="hd_id061420171139088233" dir="auto">Example:</h3>
</div>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Click on text to copy to clipboard"><pre dir="auto"><code class="language-visual-basic line-numbers">
Option VBASupport 1
Option Explicit
Sub Test_StrConv
Print StrConv("abc EFG hij", vbUpperCase) '= "ABC EFG HIJ"
Print StrConv("abc EFG hij", vbLowerCase) ' = "abc efg hij"
Print StrConv("abc EFG hij", vbProperCase) ' = "Abc Efg Hij"
REM Converts narrow (single-byte) characters in string to wide
Print StrConv("ABCDEVB¥ì¥¹¥¥å©", vbWide) ' = "ＡＢＣＤＥＶＢ￥ì￥¹￥￥å©"
REM Converts wide (double-byte) characters in string to narrow (single-byte) characters
Print StrConv("ＡＢＣＤ＠＄％２３＇？ＥＧ", vbNarrow) ' = "ABCD@$%23'?EG"
REM Converts Hiragana characters in string to Katakana characters
Print StrConv("かたかな", vbKatakana) ' = "カタカナ"
REM Converts Katakana characters in string to Hiragana characters
Print StrConv("カタカナ", vbHiragana) '= "かたかな"
REM Assumes CP-1252 encoding associated with en-US locale used in unit tests.
Dim x() As Byte
x = StrConv("ÉϺ£ÊÐABC", vbFromUnicode)
Print UBound(x) ' 8 characters
Print x(2) ' = 186
Print StrConv(x, vbUnicode)' = "ÉϺ£ÊÐABC"
End Sub
</code></pre></div>
<a name="relatedtopics"></a><div class="relatedtopics">
<p class="related" itemprop="mentions" dir="auto"><a name="related"></a><span class="emph">Related Topics</span>
</p>
<div class="relatedbody" itemprop="mentions">
<div class="embedded"><p class="embedded" dir="auto"><a target="_top" href="en-US/text/sbasic/shared/special_vba_func.html">Exclusive VBA Functions and Statements</a></p></div>
</div>
</div>
</div>
<div id="DonationFrame"></div>
<footer><div id="DEBUG" class="debug">
<h3 class="bug">Help content debug info:</h3>
<p dir="auto">This page is: <a href="https://opengrok.libreoffice.org/xref/help/source/text/sbasic/shared/strconv.xhp" target="_blank">/text/sbasic/shared/strconv.xhp</a></p>
<p dir="auto">Title is: StrConv Function [VBA]</p>
<p id="bm_module" dir="auto"></p>
<p id="bm_system" dir="auto"></p>
<p id="bm_HID" dir="auto"></p>
</div></footer>
</body>
</html>