Azure Active Directory同期関数リファレンス
更新日: 2015 年 7 月 22 日
重要
このトピックは間もなくアーカイブされます。
AADSyncと DirSync を置き換える "Azure Active Directory Connect" という新しい製品があります。
Azure AD Connect には、以前 Dirsync と AAD Sync としてリリースされたコンポーネントと機能が組み込まれています。
将来のある時点で、Dirsync と AAD Sync のサポートは終了します。
これらのツールは機能改善によって個別に更新されなくなり、今後のすべての機能強化は Azure AD Connectの更新プログラムに含まれます。
Azure Active Directory同期では、関数は同期中に属性値を操作するために使用されます。
関数の構文は、次の形式を使用して表されます。
<出力型> FunctionName(<入力型><の位置名>,..)
関数がオーバーロードされ、複数の構文を受け入れる場合は、すべての有効な構文を示します。
関数は厳密に型指定され、渡された型が文書化された型と一致することを確認します。 型が一致しない場合は、エラーがスローされます。
型は次の構文で表されます。
bin – バイナリ
bool – ブール値
dt – UTC の日付/時刻
enum – 既知の定数の列挙
exp – 評価結果にブール値が想定される式
mvbin – 複数の値を持つバイナリ
mvstr – 複数の値を持つ参照
num – 数値
ref – 1 つの値を持つ参照
str – 1 つの値を持つ文字列
var – その他の (ほとんど) すべての型のバリアント
void – 値を返しません
関数の一覧
このセクションでは、次の関数について説明します。
BitAnd
BitOr
CBool
CDate
CGuid
内容
ConvertFromBase64
ConvertFromUTF8Hex
ConvertToBase64
ConvertToUTF8Hex
Count
CNum
CRef
CStr
DateAdd
DateFromNum
DNComponent
DNComponentRev
エラー
EscapeDNComponent
FormatDateTime
GUID
IIF
InStr
InStrRev
IsBitSet
IsDate
IsEmpty
IsGuid
IsNull
IsNullOrEmpty
IsNumeric
IsString
IsPresent
アイテム
ItemOrNull
Join
LCase
Left
Len
LTrim
Mid
Now
NumFromDate
PadLeft
PadRight
PCase
RandomNum
RemoveDuplicates
Replace
ReplaceChars
Right
RTrim
Split
StringFromGuid
StringFromSid
Switch
Trim
UCase
Word
BitAnd
説明 |
BitAnd 関数は、値に指定のビットを設定します。 |
構文 |
num BitAnd(num value1, num value2) value1,value2: AND を一緒に使用する必要がある数値 |
解説 |
この関数は、両方のパラメーターをバイナリ表現に変換した後、マスクとフラグの対応するビットのいずれかまたは両方が 0 の場合にビットを 0 に設定し、対応するビットの両方が 1 の場合にビットを 1 に設定します。 つまり、両方のパラメーターの対応するビットが 1 の場合を除き、すべて 0 を返します。 |
例 |
BitAnd(&HF, &HF7) // 16 進値 "F" と "F7" は 7 に評価されるため、7 に評価されます。 |
BitOr
説明 |
BitOr 関数は、値に指定のビットを設定します。 |
構文 |
num BitOr(num value1, num value2) value1、value2: 一緒に OR で指定する必要がある数値 |
解説 |
この関数は、両方のパラメーターをバイナリ表現に変換した後、マスクとフラグの対応するビットのいずれかまたは両方が 1 の場合にビットを 1 に設定し、対応するビットの両方が 0 の場合にビットを 0 に設定します。 つまり、両方のパラメーターの対応するビットが 0 の場合を除くすべてのケースで 1 を返します。 |
例 |
CBool
説明 |
CBool 関数は、式の評価結果に基づいてブール値を返します。 |
構文 |
bool CBool(exp Expression) |
解説 |
式が 0 以外の値に評価された場合、CBool は True を返します。 それ以外の場合は False を返します。 |
例 |
CBool([attrib1] = [attrib2]) // 両方の属性が同じ値を持つ場合に True を返します。 |
CDate
説明 |
CDate 関数は、文字列から UTC DateTime を返します。 DateTime は Sync ではネイティブの属性の型ではありませんが、一部の関数で使用されます。 |
構文 |
dt CDate(str value) 値:日付、時刻、オプションでタイム ゾーンを含む文字列 |
解説 |
文字列は常に UTC で返されます。 |
例 |
CDate([employeeStartTime]) // 従業員の開始時刻に基づいた DateTime を返します CDate("2013-01-10 4:00 PM -8") // "2013-01-11 12:00 AM" を表す DateTime を返します |
CGuid
説明 |
CGuid 関数は、GUID の文字列表現を GUID のバイナリ表現に変換します。 |
構文 |
bin CGuid(str GUID)GUID: このパターンで書式設定された文字列: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx または {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} |
解説 |
|
例 |
内容
説明 |
Contains 関数は、複数値の属性内で文字列を検索します。 |
構文 |
num Contains (mvstring attribute, str search) // 大文字と小文字が区別されます num Contains (mvstring attribute, str search, enum Casetype) num Contains (mvref attribute, str search) // 大文字と小文字が区別されます attribute: 検索対象の複数値の属性。 検索: 属性内で検索する文字列。 Casetype: CaseInsensitive または CaseSensitive 文字列が見つかった複数値の属性にインデックスを返します。 文字列が見つからない場合は 0 を返します。 |
解説 |
複数値文字列属性の場合、値の部分文字列が検索されます。 参照属性の場合、一致と見なされるためには、検索された文字列は正確に値と一致する必要があります。 |
例 |
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No primary SMTP address found.")) proxyAddresses 属性にプライマリ 電子メール アドレス (大文字の "SMTP:"で示されます) がある場合は、proxyAddress 属性を返し、それ以外の場合はエラーを返します。 |
ConvertFromBase64
説明 |
ConvertFromBase64 関数は、指定した base64 でエンコードされた値を正規の文字列に変換します。 |
構文 |
str ConvertFromBase64(str source) // エンコードとして Unicode を想定しています str ConvertFromBase64(str source, enum Encoding) ソース: Base64 でエンコードされた文字列 Encoding:Unicode、ASCII、UTF8 |
解説 |
|
例 |
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA") ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8) // どちらも "Hello world!" を返します |
ConvertFromUTF8Hex
説明 |
ConvertFromUTF8Hex 関数は、指定した UTF8 の 16 進数でエンコードされた値を文字列に変換します。 |
構文 |
str ConvertFromUTF8Hex(str source) source:UTF8 の 2 バイトでエンコードされた文字列 |
解説 |
この関数は、その結果が DN 属性に適している点で、ConvertFromBase64([],UTF8) とは異なります。 この形式は、Azure Active Directory によって DN として使用されます。 |
例 |
ConvertFromUTF8Hex("48656C6C6F20776F726C6421") // "Hello world!" を返します |
ConvertToBase64
説明 |
ConvertToBase64 関数は、文字列を Unicode の base64 文字列に変換します。 整数の配列の値を、base 64 桁でエンコードされているそれと同等の文字列表現に変換します。 |
構文 |
str ConvertToBase64(str source) |
解説 |
|
例 |
ConvertToBase64("Hello world!") // "SABlAGwAbABvACAAdwBvAHIAbABkACEA" を返します |
ConvertToUTF8Hex
説明 |
ConvertToUTF8Hex 関数は、文字列を UTF8 の 16 進数でエンコードされた値に変換します。 |
構文 |
str ConvertToUTF8Hex(str source) |
解説 |
この関数の出力形式は、Azure Active Directory によって DN 属性形式として使用されます。 |
例 |
ConvertToUTF8Hex("Hello world!") // 48656C6C6F20776F726C6421 を返します |
Count
説明 |
Count 関数は、複数値の属性内の要素数を返します。 |
構文 |
num Count(mvstr attribute) |
解説 |
|
例 |
CNum
説明 |
CNum 関数は、文字列を受け取り、数値データ型を返します。 |
構文 |
num CNum(str value) |
解説 |
|
例 |
CRef
説明 |
文字列を参照属性に変換します。 |
構文 |
ref CRef(str value) |
解説 |
|
例 |
CRef("CN=LC Services,CN=Microsoft,CN=lcspool01, CN=Pools,CN=RTC Service," & %Forest.LDAP%) |
CStr
説明 |
CStr 関数は、文字列データ型に変換します。 |
構文 |
str CStr(num value) str CStr(ref value) str CStr(bool value) 値: 数値、参照属性、またはブール値を指定できます。 |
解説 |
|
例 |
CStr([dn]) // たとえば、"cn=Joe,dc=contoso,dc=com" を返します |
DateAdd
説明 |
指定した時間間隔が追加された日付を含む Date を返します。 |
構文 |
dt DateAdd(str interval, num value, dt date) 間隔: 追加する間隔である文字列式。 文字列には次のいずれかの値が必要です。 yyyy: 年 q: 四半期 m: 月 y: 年間通算日 d: 日 w: 週日 ww: 週 h: 時 n: 分 s: 秒 値: 追加する単位の数。 正の数 (将来の日時を取得する場合) または負の数 (過去の日時を取得する場合) を指定できます。 日付: 間隔が追加される日付を表す DateTime。 |
解説 |
|
例 |
DateAdd("m"、3、CDate("2001-01-01")), // 3 か月を加算し、"2001-04-01" を表す DateTime を返します |
DateFromNum
説明 |
DateFromNum 関数は、AD の日付形式の値を DateTime 型に変換します。 |
構文 |
dt DateFromNum(num value) |
解説 |
|
例 |
DateFromNum([lastLogonTimestamp]) DateFromNum(129699324000000000) // 2012-01-01 23:00:00 を表す DateTime を返します |
DNComponent
説明 |
DNComponent 関数は、指定した DN コンポーネントの値を左から返します。 |
構文 |
str DNComponent(ref dn, num ComponentNumber) dn: 解釈する参照属性 ComponentNumber:返される DN のコンポーネント |
解説 |
|
例 |
DNComponent([dn],1) dn が "cn=Joe,ou=... の場合 これは Joe を返します |
DNComponentRev
説明 |
DNComponentRev 関数は、指定した DN コンポーネントの値を右 (端) から返します。 |
構文 |
str DNComponentRev(ref dn, num ComponentNumber) str DNComponentRev(ref dn, num ComponentNumber, enum Options)dn: 解釈する参照属性 ComponentNumber:返される DN のコンポーネント オプション: DC – "dc=" を持つすべてのコンポーネントを無視する |
解説 |
|
例 |
// dn が "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" の場合、DNComponentRev([dn],3) と DNComponentRev([dn],1,"DC") // のどちらも US を返します。 |
エラー
説明 |
Error 関数は、カスタム エラーを返すために使用します。 |
構文 |
void Error(str ErrorMessage) |
解説 |
|
例 |
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required")) // accountName 属性が存在しない場合、オブジェクトでエラーをスローします。 |
EscapeDNComponent
説明 |
EscapeDNComponent 関数は、DN のコンポーネントを 1 つ受け取り、LDAP で表示できるようにそれをエスケープします。 |
構文 |
str EscapeDNComponent(str value) |
解説 |
|
例 |
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP% // LDAP においてエスケープする必要がある文字が displayName 属性に含まれている場合でもオブジェクトを LDAP ディレクトリに作成できるようにします。 |
FormatDateTime
説明 |
FormatDateTime 関数は、DateTime を指定した形式の文字列に設定するために使用します。 |
構文 |
str FormatDateTime(dt 値, str format)value: DateTime 形式の値 format: 変換する形式を表す文字列。 |
解説 |
形式で有効な値については、 |
例 |
FormatDateTime(CDate(“12/25/2007”),"yyyy-mm-dd") // "2007-12-25" が返されます。 FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z") // たとえば、"20140905081453.0Z" が返されます。 |
GUID
説明 |
GUID 関数は、新しいランダムな GUID を生成します。 |
構文 |
str GUID() |
解説 |
|
例 |
IIF
説明 |
IIF 関数は、指定した条件に基づいて、使用できる一連の値のうち、いずれかを返します。 |
構文 |
var IIF(exp condition, var valueIfTrue, var valueIfFalse)condition: true または false に評価できる任意の値または式。 valueIfTrue: 条件が true に評価された場合に返される値。 valueIfFalse: 条件が false に評価された場合に返される値。 |
解説 |
|
例 |
IIF([employeeType]="Intern","t-"&[alias],[alias]) // ユーザーがインターンの場合に "t-" を先頭に付けてユーザーのエイリアスを返し、それ以外の場合はユーザーのエイリアスをそのまま返します。 |
InStr
説明 |
InStr 関数は文字列内の最初の部分文字列を検索します。 |
構文 |
num InStr(str stringcheck, str stringmatch) num InStr(str stringcheck, str stringmatch, num start) num InStr(str stringcheck, str stringmatch, num start , enum compare) Stringcheck: 検索する文字列 Stringmatch: 見つかる文字列 開始: 部分文字列を検索する開始位置 比較: vbTextCompare または vbBinaryCompare |
解説 |
部分文字列が見つかった位置を返します。見つからなかった場合は 0 を返します。 |
例 |
InStr("The quick brown fox","quick") // 5 に評価されます InStr("repEated","e",3,vbBinaryCompare) // 7 に評価されます |
InStrRev
説明 |
InStrRev 関数は文字列内の最後の部分文字列を検索します。 |
構文 |
num InstrRev(str stringcheck, str stringmatch) num InstrRev(str stringcheck, str stringmatch, num start) num InstrRev(str stringcheck, str stringmatch, num start, enum compare) Stringcheck: 検索する文字列 Stringmatch: 見つかる文字列 開始: 部分文字列を検索する開始位置 比較: vbTextCompare または vbBinaryCompare |
解説 |
部分文字列が見つかった位置を返します。見つからなかった場合は 0 を返します。 |
例 |
InStrRev("abbcdbbbef","bb") // 7 に評価されます |
IsBitSet
説明 |
IsBitSet 関数は、ビットが設定されているかどうかをテストします。 |
構文 |
bool IsBitSet(num value, num flag) value: 評価対象の数値。flag: 評価対象のビットがある数値。 |
解説 |
|
例 |
IsBitSet(&HF,4) // ビット "4" が 16 進値 "F" に設定されているため、True に評価されます |
IsDate
説明 |
IsDate 関数は、式が DateTime 型として評価できる場合に True を返します。 |
構文 |
bool IsDate(var Expression) |
解説 |
CDate() が成功するかどうかを判定するために使用します。 |
例 |
IsEmpty
説明 |
IsEmpty 関数は、属性が CS または MV に存在する一方で空の文字列に評価される場合に True を返します。 |
構文 |
bool IsEmpty(var Expression) |
解説 |
|
例 |
IsGuid
説明 |
IsGuid 関数は、文字列を GUID に変換できなかった場合に true を返します。 |
構文 |
bool IsGuid(str GUID) |
解説 |
GUID は次のいずれかのパターンに従った文字列として定義されます: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx または {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} CGuid() が成功するかどうかを判定するために使用します。 |
例 |
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL) // StrAttribute が GUID 形式である場合はバイナリ表現を返し、それ以外の場合は Null を返します。 |
IsNull
説明 |
IsNull 関数は、式が Null に評価される場合に true を返します。 |
構文 |
bool IsNull(var Expression) |
解説 |
属性の場合、Null は属性の不在によって表されます。 |
例 |
IsNull([displayName]) // 属性が CS または MV に存在しない場合、True に評価されます。 |
IsNullOrEmpty
説明 |
IsNullOrEmpty 関数は、式が null または空の文字列である場合に true を返します。 |
構文 |
bool IsNullOrEmpty(var Expression) |
解説 |
属性の場合は、属性がないか、存在しても空の文字列の場合、評価結果は True になります。 この関数の逆の関数は IsPresent です。 |
例 |
IsNull([displayName]) // 属性が CS または MV に存在しないか、または空の文字列である場合、True に評価されます。 |
IsNumeric
説明 |
IsNumeric 関数は、式を数値型として評価できるかどうかを示すブール値を返します。 |
構文 |
bool IsNumeric(var Expression) |
解説 |
式を解析する際に CNum() が成功するかどうかを判定するために使用します。 |
例 |
IsString
[説明] |
IsString 関数は、式を文字列型に評価できる場合に True を返します。 |
構文 |
bool IsString(var expression) |
解説 |
式を解析する際に CStr() が成功するかどうかを判定するために使用します。 |
例 |
IsPresent
説明 |
IsPresent 関数は、式が Null でもなく空でもない文字列に評価される場合に true を返します。 |
構文 |
bool IsPresent(var expression) |
解説 |
この関数の逆関数は IsNullOrEmpty です。 |
例 |
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director]) |
アイテム
説明 |
Item 関数は複数値の文字列/属性から 1 つの項目を返します。 |
構文 |
var Item(mvstr attribute, num index) attribute: 複数値の属性 index: 複数値の文字列内の項目へのインデックス。 |
解説 |
Item 関数は、複数値の属性内の項目のインデックスを返す Contains 関数と組み合わせると便利です。 インデックスが範囲外にある場合は、エラーをスローします。 |
例 |
Mid(Item([proxyAddress],Contains([proxyAddress], "SMTP:")),6) // 通常の電子メール アドレスを返します。 |
ItemOrNull
説明 |
ItemOrNull 関数は複数値の文字列/属性から 1 つの項目を返します。 |
構文 |
var ItemOrNull(mvstr attribute, num index) attribute: 複数値の属性 index: 複数値の文字列内の項目へのインデックス。 |
解説 |
ItemOrNull 関数は、複数値の属性内の項目のインデックスを返す Contains 関数と組み合わせると便利です。 インデックスが範囲外の場合は、Null 値を返します。 |
例 |
Join
説明 |
Join 関数は、複数値の文字列を受け取り、指定した区切り記号が項目間に挿入された、単一値の文字列を返します。 |
構文 |
str Join(mvstr attribute) str Join(mvstr 属性, str Delimiter)属性: 結合する文字列を含む複数値属性。 区切り記号: 返された文字列内の部分文字列を区切るために使用される任意の文字列。 省略した場合は、空白文字 (" ") が使用されます。 delimiter が長さ 0 の文字列 ("") または Nothing の場合、リスト内のすべての項目は、区切り記号なしで連結されます。 |
解説 |
Join 関数と Split 関数の間には類似点があります。 Join 関数は、文字列の配列を受け取り、区切り文字列を使用してそれらを結合し、単一の文字列を返します。 Split 関数は、文字列を受け取って区切り記号で分割し、文字列の配列を返します。 ただし、Join 関数が任意の区切り文字列を使った文字列を連結できるのに対し、Split 関数で文字列を分割する際には 1 文字の区切り記号しか使用できないという大きな違いがあります。 |
例 |
Join([proxyAddresses],",") 返される可能性があります: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com" |
LCase
説明 |
LCase 関数は、文字列内のすべての文字を小文字に変換します。 |
構文 |
str LCase(str value) |
解説 |
|
例 |
LCase("TeSt") // "test" が返されます。 |
Left
説明 |
Left 関数は文字列の左端から数えて指定した文字数分の文字を返します。 |
構文 |
str Left(str string, num NumChars)string: 文字を返す文字列 NumChars: 文字列の左端から数えて返される文字数を指定する数値 |
解説 |
string 内の最初の numChars に指定された数の文字が含まれている文字列。 •numChars が 0 の場合、空の文字列が返されます。 •numChars 0 の場合は < 、入力文字列を返します。 •string が null の場合、空の文字列が返されます。 string に含まれる文字数が numChars に指定された数より少ない場合、string と同じ文字列 (つまり、パラメーター 1 のすべての文字が含まれた文字列) が返されます。 |
例 |
Left("John Doe", 3) // "Joh" を返します。 |
Len
説明 |
Num 関数は、文字列内の文字数を返します。 |
構文 |
num Len(str value) |
解説 |
|
例 |
Len("John Doe") // 8 を返します |
LTrim
説明 |
LTrim 関数は文字列の先頭の空白文字を削除します。 |
構文 |
str LTrim(str value) |
解説 |
|
例 |
LTrim(" テスト ") "Test" の結果 |
Mid
説明 |
Mid 関数は文字列の指定した位置から数えて、指定した文字数分の文字を返します。 |
構文 |
str Mid(str string, num start, num NumChars) string: 返される文字を含む文字列 start: 文字列内で返される文字の開始位置を指定する数値 NumChars: 文字列の位置から数えて返される文字数を指定する数値 |
解説 |
string 内の start 位置から数えて numChars 文字分の文字を返します。 string 内の start を開始位置とする numChars に指定された数の文字が含まれている文字列。 •numChars が 0 の場合、空の文字列が返されます。 •numChars 0 の場合は < 、入力文字列を返します。 •文字列の長さを開始 > する場合は、入力文字列を返します。 •start <= 0 の場合は、入力文字列を返します。 •string が null の場合、空の文字列が返されます。 string の開始位置 start 以降に numChars に指定された数の文字がない場合は、取得できる限りの数の文字が返されます。 |
例 |
Mid("John Doe", 3, 5) // "hn Do" を返します。 Mid("John Doe", 6, 999) // "Doe" を返します。 |
Now
説明 |
Now 関数は、コンピューターのシステム日時に基づいて、現在の日付と時刻を示す DateTime を返します。 |
構文 |
dt Now() |
解説 |
|
例 |
NumFromDate
説明 |
NumFromDate 関数は、AD の日付形式で日付を返します。 |
構文 |
num NumFromDate(dt value) |
解説 |
|
例 |
NumFromDate(CDate("2012-01-01 23:00:00")) // 129699324000000000 を返します |
PadLeft
説明 |
PadLeft 関数は、指定した埋め込み文字を使用して、指定した長さになるまで左側に文字列を埋め込みます。 |
構文 |
str PadLeft(str string, num length, str padCharacter) string: 埋め込む文字列。 length:文字列の必要な長さを表す整数。 padCharacter:埋め込み文字として使用する 1 文字で構成された文字列。 |
解説 |
文字列の長さが length 未満の場合、長さが length と等しくなるまで文字列の左端に padCharacter が繰り返し追加されます。 PadCharacter には空白文字を指定できますが、null 値を指定することはできません。 文字列の長さが length 以上の場合、文字列は変更されない状態で返されます。 文字列に length 以上の長さがある場合、文字列と同一の文字列が返されます。 文字列の長さが length 未満の場合、padCharacter が埋め込まれた文字列が含まれる、必要な長さの新しい文字列が返されます。 string が null の場合、この関数は空の文字列を返します。 |
例 |
PadLeft("User", 10, "0") // "000000User" が返されます。 |
PadRight
説明 |
PadRight 関数は、指定した埋め込み文字を使用して、指定した長さになるまで右側に文字列を埋め込みます。 |
構文 |
str PadRight(str string, num length, str padCharacter) string: 埋め込む文字列。 length:文字列の必要な長さを表す整数。 padCharacter:埋め込み文字として使用する 1 文字で構成された文字列。 |
解説 |
文字列の長さが length 未満の場合、長さが length と等しくなるまで文字列の右端に padCharacter が繰り返し追加されます。 PadCharacter には空白文字を指定できますが、null 値を指定することはできません。 文字列の長さが length 以上の場合、文字列は変更されない状態で返されます。 文字列に length 以上の長さがある場合、文字列と同一の文字列が返されます。 文字列の長さが length 未満の場合、padCharacter が埋め込まれた文字列が含まれる、必要な長さの新しい文字列が返されます。 string が null の場合、この関数は空の文字列を返します。 |
例 |
PadRight("User", 10, "0") // "User000000" が返されます。 |
PCase
説明 |
PCase 関数は、文字列内のスペースで区切られた単語の最初の文字を大文字に変換し、その他のすべての文字を小文字に変換します。 |
構文 |
String PCase(string) |
解説 |
|
例 |
PCase("TEsT") // "Test" が返されます。 |
RandomNum
説明 |
RandomNum 関数は、指定した範囲内の乱数を返します。 |
構文 |
num RandomNum(num start, num end) start: 生成するランダムな値の下限を指定する数値 end: 生成するランダムな値の上限を指定する数値 |
解説 |
|
例 |
Random(100,999) // たとえば、734 を返します。 |
RemoveDuplicates
説明 |
RemoveDuplicates 関数は複数値の文字列を受け取り、各値が一意になるように処理します。 |
構文 |
mvstr RemoveDuplicates(mvstr attribute) |
解説 |
|
例 |
RemoveDuplicates([proxyAddresses]) // すべての重複値が削除された校正済みの proxyAddress 属性が返されます。 |
Replace
説明 |
Replace 関数は、見つかった文字列をすべて別の文字列に置き換えます。 |
構文 |
str Replace(str string, str OldValue, str NewValue) string:値を置換する文字列。 OldValue:検索し、置換される文字列。 NewValue:置換する文字列。 |
解説 |
この関数は、次の特殊なモニカーを認識します。 \n – 新しい行 \r – キャリッジ リターン \t – タブ |
例 |
Replace([address],"\r\n",", ") // CRLF をコンマと空白で置換して、たとえば "One Microsoft Way, Redmond, WA, USA" を返します |
ReplaceChars
説明 |
ReplaceChars 関数は、ReplacePattern 文字列に見つかったすべての文字を置き換えます。 |
構文 |
str ReplaceChars(str string, str ReplacePattern) string:文字を置換する文字列。 ReplacePattern: 置換する文字のディクショナリが含まれる文字列。 形式は {source1}:{target1},{source2}:{target2},{sourceN},{targetN} です。source は検索対象の文字、target は置換する文字列です。 |
解説 |
この関数は、定義されている source のすべての出現箇所を target で置換します。 source は、厳密に 1 文字 (unicode) である必要があります。 source は、空にすることも 2 文字以上にすることもできません (解析エラー)。 ターゲットには、ö:oe、β:ss など、複数の文字を含めることができます。 target を空にして、文字を削除する必要があることを指定できます。 source では大文字と小文字が区別されます。source の大文字と小文字が完全に一致する必要があります。 「,」(コンマ) と「:」(コロン) は予約文字であり、この関数を使用して置き換えることはできません。 ReplacePattern 文字列内のスペースやその他の空白文字は無視されます。 |
例 |
%ReplaceString% = ':,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o ReplaceChars("Räksmörgås",%ReplaceString%) // Raksmorgas を返します ReplaceChars("O'Neil",%ReplaceString%) // "ONeil" を返します。単一引用符は削除されます。 |
Right
説明 |
Right 関数は文字列の右端から数えて指定した文字数分の文字を返します。 |
構文 |
str Right(str string, num NumChars) string: 返される文字を含む文字列 NumChars: 文字列の右端から数えて返される文字数を指定する数値 |
解説 |
string の末尾から数えて numChars 文字分の文字が返されます。 string 内の最後の numChars に指定された数の文字が含まれている文字列。 •numChars が 0 の場合、空の文字列が返されます。 •numChars 0 の場合は < 、入力文字列を返します。 •string が null の場合、空の文字列が返されます。 文字列に含まれる文字数が NumChars に指定した数より少ない場合は、文字列と同一の文字列が返されます。 |
例 |
Right("John Doe", 3) // "Doe" を返します。 |
RTrim
説明 |
RTrim 関数は文字列の末尾の空白文字を削除します。 |
構文 |
str RTrim(str value) |
解説 |
|
例 |
RTrim(" Test ") 結果は "Test" です。 |
Split
説明 |
Split 関数は区切り記号で区切られた文字列を受け取り、複数値の文字列にします。 |
構文 |
mvstr Split(str value, str delimiter) mvstr Split(str value, str delimiter, num limit) 値: 区切り文字を区切る文字列。 区切り記号: 区切り記号として使用する 1 文字 制限: 返される値の最大数 |
解説 |
|
例 |
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",") // proxyAddress 属性に便利な 2 つの要素を含む複数値の文字列を返します |
StringFromGuid
[説明] |
StringFromGuid 関数は、バイナリ GUID を受け取り、文字列に変換します。 |
構文 |
str StringFromGuid(bin GUID) |
解説 |
|
例 |
StringFromSid
説明 |
StringFromSid 関数は、セキュリティ識別子を含むバイト配列または複数値のバイト配列を、文字列または複数値の文字列に変換します。 |
構文 |
str StringFromSid(bin ObjectSID) mvstr StringFromSid(mvbin ObjectSID) |
解説 |
|
例 |
Switch
説明 |
Switch 関数は、条件の評価結果に基づいて 1 つの値を返すために使用します。 |
構文 |
var Switch(exp expr1, var value1[, exp expr2, var value ... [, exp expr, var valueN]]) Expr: 評価するバリアント式。 値: 対応する式が True の場合に返される値。 |
解説 |
Switch 関数の引数リストは、式と値のペアで構成されます。 式は左から右に評価され、評価結果が True になる最初の式に関連付けられている値が返されます。 各部分が正しくペアリングされていないと、実行時エラーが発生します。 たとえば、expr1 が True の場合、Switch は value1 を返します。 たとえば、expr1 が False でも expr2 が True の場合、Switch は value2 を返します。 次の場合、Switch は Nothing を返します。
返される式が 1 つであっても、Switch はすべての式を評価します。 このため、望ましくない影響が発生しないよう注意する必要があります。 たとえば、式の評価結果が 0 除算のエラーの場合、エラーが発生します。 Value には、カスタム文字列を返す Error 関数を指定することもできます。 |
例 |
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city")) // いくつかの主要都市で話されている言語を返し、それ以外の場合はエラーを返します。 |
Trim
説明 |
Trim 関数は、文字列の先頭と末尾の空白文字を削除します。 |
構文 |
str Trim(str value) mvstr Trim(mvstr value) |
解説 |
|
例 |
Trim(" Test ") // "Test" が返されます。 Trim([proxyAddresses]) // proxyAddress 属性のそれぞれの値の先頭および末尾のスペースを削除します。 |
UCase
[説明] |
UCase 関数は文字列内のすべての文字を大文字に変換します。 |
構文 |
str UCase(str string) |
解説 |
|
例 |
UCase("TeSt") // "TEST" が返されます。 |
Word
説明 |
Word 関数は、使用する区切り記号と返す単語の番号を表すパラメーターに基づいて、文字列内に含まれる単語を返します。 |
構文 |
str Word(str string, num WordNumber, str delimiters) string: 単語を返す文字列 WordNumber: 返される単語番号を識別する数値 delimiters: 単語を識別するために使用される区切り記号を表す文字列 |
解説 |
string 内で delimiters のいずれかの文字で区切られたそれぞれの文字列が単語として識別されます。 •数値 < 1 の場合は、空の文字列を返します。 •string が null の場合、空の文字列が返されます。 string に含まれる単語の数が単語番号未満の場合、または区切り文字で識別される単語が string に含まれていない場合は、空の文字列が返されます。 |
例 |
Word("The quick brown fox",3," ") // "brown" を返します。 Word("This,string!has&many seperators",3,",,!&#") // "has" を返します。 |