<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="pt-br" xml:lang="pt-br">
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="(C) Copyright 2005" />
<meta name="DC.rights.owner" content="(C) Copyright 2005" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="reference" name="DC.Type" />
<meta name="DC.Title" content="SUBSTR" />
<meta content="Função SUBSTR" name="DC.subject" />
<meta content="Função SUBSTR" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="rrefsqlj29026.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="rrefsqlj93082" name="DC.Identifier" />
<meta content="pt-br" name="DC.Language" />
<link href="commonltr.css" type="text/css" rel="stylesheet" />
<title>SUBSTR</title>
</head>
<body id="rrefsqlj93082"><a name="rrefsqlj93082"><!-- --></a>


<h1 class="topictitle1">SUBSTR</h1>


<div>
<div class="section">
<p>A função SUBSTR atua sobre uma expressão cadeia de caracteres ou uma
expressão cadeia de bits.
No primeiro caso o tipo do resultado é
<a href="rrefsqlj41207.html#rrefsqlj41207">VARCHAR</a>,
e no segundo caso é
<a href="rrefsqlj32714.html#rrefsqlj32714">VARCHAR FOR BIT DATA</a>.
O comprimento do resultado é o comprimento máximo do tipo de origem.</p>

</div>

<div class="section"><h2 class="sectiontitle">Sintaxe</h2>

<pre><strong>SUBSTR({ <em>ExpressãoCaractere</em> },
   <em>PosiçãoInicial</em> [, <em>ComprimentoCadeia</em> ] )</strong>
</pre>

<p>A <em>PosiçãoInicial</em> e o parâmetro opcional <em>ComprimentoCadeia</em>
são ambos expressões inteiras (O primeiro caractere ou bit possui
<em>PosiçãoInicial</em> igual a 1; se for especificado 0, o
<span>Derby</span>
assume que é 1).</p>

<p>A <em>ExpressãoCaractere</em> é do tipo de dado CHAR, VARCHAR ou LONG VARCHAR,
ou de qualquer tipo de dado nativo que seja convertido implicitamente em uma
cadeia (exceto a expressão de bit).</p>

<p>Para as expressões caractere, tanto <em>PosiçãoInicial</em> quanto
<em>ComprimentoCadeia</em> se referem a caracteres.
Para expressões de bit, tanto <em>PosiçãoInicial</em> quanto
<em>ComprimentoCadeia</em> se referem a bits.</p>

<p>SUBSTR retorna NULL se for especificado <em>ComprimentoCadeia</em>, e este
for menor que zero.</p>

<p>Se <em>PosiçãoInicial</em> for positiva, então se refere a posição a partir
do início da expressão de origem (contando o primeiro caractere como 1).
Se <em>PosiçãoInicial</em> for negativa, então é a posição a partir do fim da
origem.</p>

<p>Se não for especificado <em>ComprimentoCadeia</em>, então SUBSTR retornará
a subcadeia da expressão desde a <em>PosiçãoInicial</em> até o fim da expressão
de origem.
Se for especificado <em>ComprimentoCadeia</em>, então SUBSTR retornará um
VARCHAR ou VARBIT com comprimento <em>ComprimentoCadeia</em> a partir da
<em>PosiçãoInicial</em>.</p>

</div>

</div>

<div>
<div class="familylinks">
<div class="parentlink"><strong>Tópico pai:</strong> <a href="rrefsqlj29026.html" title="">Funções nativas</a></div>
</div>
</div>

</body>
</html>
