VBA関数
CVErr関数

Excelマクロで必須のVBA関数を入門・初級・初心者向けに詳細解説
最終更新日:2021-08-23

CVErr関数


CVErr関数は、指定した数値(エラー番号)を、バリアント型のエラー値に変換した値を返す変換関数です。


CVErr関数

CVErr(errornumber)

errornumber
任意の数値 (エラー番号) を指定します。
この引数は必ず指定します。

CVErr 関数を使用して、作成したプロシージャ内でユーザー定義のエラーを作成できます。
CVErr 関数を使用することにより、どのような動作が行われたのかを知らせるエラー番号を返すことができます。

エラー番号のデータ型を暗黙的に変換することはできません。
たとえば、CVErr 関数の戻り値をバリアント型以外の変数に直接代入することはできません。


CVErr関数の使用例

ヘルプのサンプルです。

' エラーが発生する値 (ここでは、文字列) を引数として指定し、Function プロシージャ CalculateDouble を呼び出します。
Sub Test()
  Debug.Print CalculateDouble("345.45robert")
End Sub

' Function プロシージャ CalculateDouble を定義します。
Function CalculateDouble(Number)
  If IsNumeric(Number) Then    ' 受け取った値が数値であれば、
    CalculateDouble = Number * 2  ' 結果を返します。
  Else              ' 数値以外のときは、
    CalculateDouble = CVErr(2001)  ' ユーザー定義のエラー値を返します。
  End If
End Function

CVErr関数を使用して作成するFunctionプロシージャは、戻り型がVariantで指定する事になります。

Variantを使う事自体は問題ありませんが、受け取った呼出し側で正常処理とエラー処理を分けざるを得なくなります。

結局受け取った側でエラー判定が必要になるなら、CalculateDoubleを呼ぶ前に数値チェックを行うことと変わりがありません。
したがって、この例は実用的なVBAとは言えません。
あくまで、CVErr関数の動作確認のVBAとお考え下さい。

実行時エラー関連記事

第60回.エラー処理(On Error)
マクロを実行していると、エラーメッセージが表示されマクロ実行が停止してしまう事があります。マクロがエラー停止しては自動化の目的が達成されませんので、エラー停止しないようにしなければなりません。エラーが出ないようにVBAを記述出来ればそれに越したことはありませんが、一切エラーを出さないようにVBAを書くことはかなり困…
第61回.「On Error GoTo」と「Exit Sub」
「OnErrorGoTo行ラベル」このステートメントは、実行時エラーが発生した時に、制御を指定の行ラベルに移動させるものです。マクロVBAは、エラーが発生するとその時点で停止してしまいます。VBAが実行不能となった場合に、エラー発生したVBAコードで停止します。
第62回.「On Error Resume Next」とErrオブジェクト
「OnErrorResumeNext」ステートメントは、実行時エラーが発生してもマクロVBAを中断せずに、エラーが発生したステートメントの次のステートメントから実行を継続します。マクロVBAは、エラーが発生するとその時点で停止してしまいます。
第134回.Errオブジェクトとユーザー定義エラー
VBA実行時には種々のエラーが発生します。実行時エラーに関する情報は、Errオブジェクトには入っていますので、VBA実行でエラー発生した場合は、Errオブジェクトを参照しエラー内容を調べることになります。Errオブジェクトの使い方と、ユーザー定義エラーの生成方法について解説します。
実行時にトラップ可能なエラー番号一覧と対処
マクロVBA実行時に発生するエラーのエラー番号とエラーメッセージおよび簡単な理由と対策の一覧です。以下の表にあるエラーはトラップ(捕捉)できるエラー一覧になります。OnErrorステートメントおよびErrオブジェクトのNumberロパティを使用して、エラーへの対処を行うことができます。
よくあるVBA実行時エラーの解説と対応
VBAを書き終えて、いざ実行したら意味不明なメッセージが… ここでは初心者向けに、代表的な実行時エラーの解説とその対応について説明します。中級者以上の方は、実行時にトラップ可能なエラー番号一覧と対処 こちらを参考に、エラー対応(OnError等)を実装してください。

データ型変換関数一蘭

関数名 戻り値の種類 引数の範囲
CBool関数 Boolean 任意の有効な文字列式または数式を指定します。
CByte関数 Byte 0 から 255。
CCur関数 Currency -922,337,203,685,477.5808 ~ 922,337,203,685,477.5807。
CDate関数 Date 任意の有効な日付式。
CDbl関数 Double 負の値の場合は -1.79769313486231E308 ~ -4.94065645841247E-324
正の値の場合は4.94065645841247E-324 ~ 1.79769313486232E308。
CDec関数 Decimal ゼロスケールの値 (小数部分がない値) の場合は 79,228,162,514,264,337,593,543,950,335 です。
小数点以下が 28 桁の値の場合は 7.9228162514264337593543950335 です。
0 以外で可能な最小値は 0.0000000000000000000000000001 です。
CInt関数 Integer -32,768 から 32,767。
小数点以下は丸められます。
CLng関数 Long -2,147,483,648 から 2,147,483,647。
小数点以下は丸められます。
CLngLng関数 LongLong -9,223,372,036,854,775,808 から 9,223,372,036,854,775,807。
小数点以下は丸められます (64 ビット プラットフォームのみで有効)。
CLngPtr関数 LongPtr 32 ビットのシステムでは -2,147,483,648 ~ 2,147,483,647
64 ビットのシステムでは -9,223,372,036,854,775,808 ~ 9,223,372,036,854,775,807。
32 ビットと 64 ビットのどちらのシステムでも、小数部分は丸められます。
CSng関数 Single 負の値の場合は -3.402823E38 ~ -1.401298E-45
正の値の場合は 1.401298E-45 ~ 3.402823E38。
CStr関数 String CStr の戻り値は、引数に依存します。
CVar関数 Variant 数値の場合はDoubleと同じ範囲です。
数値以外の場合はStringと同じ範囲です。


Office VBA リファレンス データ型変換関数


※VBA関数一覧
マクロVBA関数の一覧と解説です、どんな関数があるかは一度は確認しておくとをお勧めいたします。どんな関数があるだけでも知っておけば、詳細の使い方は実際に使うときに調べても良いでしょう。文字列操作…34 分岐…3 型変換…14 データ判定…10 日付時刻…20 配列…6 ファイル操作…14 数学/財務…28 その他……



同じテーマ「VBA関数」の記事

CSng関数
CStr関数
CVar関数
CVErr関数
IsArray関数
IsDate関数
IsEmpty関数
IsError関数
IsMissing関数
IsNull関数
IsNumeric関数


新着記事NEW ・・・新着記事一覧を見る

VLOOKUPを使うことを基本としてシートを設計すべきか|エクセル雑感(2021-08-17)
コンピューターはブラックボックスで良い|エクセル雑感(2021-08-14)
小文字"abc"を大文字"ABC"に変換する方法|エクセル雑感(2021-08-13)
ADOでテキストデータを集計する|VBAサンプル集(2021-08-04)
VBA学習のお勧めコース|エクセル雑感(2021-08-01)
エクセル馬名ダービー|エクセル雑感(2021-07-21)
在庫を減らせ!毎日棚卸ししろ!|エクセル雑感(2021-07-05)
日付型と通貨型のValueとValue2について|エクセル雑感(2021-06-26)
DXってなんだ? ITと何が違うの?|エクセル雑感(2021-06-24)
エクセルVBA 段級位 目安|エクセル雑感(2021-06-21)


アクセスランキング ・・・ ランキング一覧を見る

1.最終行の取得(End,Rows.Count)|VBA入門
2.Excelショートカットキー一覧|Excelリファレンス
3.変数宣言のDimとデータ型|VBA入門
4.RangeとCellsの使い方|VBA入門
5.繰り返し処理(For Next)|VBA入門
6.マクロって何?VBAって何?|VBA入門
7.Range以外の指定方法(Cells,Rows,Columns)|VBA入門
8.セルのコピー&値の貼り付け(PasteSpecial)|VBA入門
9.セルに文字を入れるとは(Range,Value)|VBA入門
10.とにかく書いてみよう(Sub,End Sub)|VBA入門




このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。


記述には細心の注意をしたつもりですが、
間違いやご指摘がありましたら、「お問い合わせ」からお知らせいただけると幸いです。
掲載のVBAコードは動作を保証するものではなく、あくまでVBA学習のサンプルとして掲載しています。
掲載のVBAコードは自己責任でご使用ください。万一データ破損等の損害が発生しても責任は負いません。



このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。
本文下部へ