macro/command/ispassword.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <title>ispassword</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>ispassword</h1>

<p>
Determines if a password is stored. <em>(version 4.75 or later)</em>
</p>

<h2>Format</h2>

<pre class="macro-syntax">
ispassword &lt;filename&gt; &lt;password name&gt;
</pre>

<h2>Remarks</h2>

<p>
A password identified by &lt;password name&gt; from the password file &lt;filename&gt; is determined if the password is stored in the file.<br>
</p>

<p>
When a password identified by &lt;password name&gt; exists in the password file, the system variable "result" is set to 1. Otherwise, "result" is set to 0.
</p>

<h2>Example</h2>

<pre class="macro-example">
strdim pw 2
username = 'yutaka'

<strong>ispassword</strong> 'pw.dat' username ; result: 0=false; 1=true
if result = 1 then
  getpassword 'pw.dat' username pw[0]
  pw[1] = pw[0]
else
  msg = 'What is your password for '
  strconcat msg username
  strconcat msg '?'
  passwordbox msg 'Enter your password'
  pw[0] = inputstr
  pw[1] = pw[0]
  setpassword 'pw.dat' username pw[0]
endif
</pre>

<h2>See also</h2>
<ul>
  <li><a href="getpassword.html">getpassword</a></li>
  <li><a href="setpassword.html">setpassword</a></li>
</ul>

</body>
</html>