R 関数

関数は、一緒にタスクを実行する一連の文です。R言語自体には多くの組み込み関数が用意されていますが、もちろん自分で関数を作成することもできます。

コードを複数の異なる関数に分割することができます。コードをどのように関数に分割するかはあなた次第ですが、論理的には、通常は各関数が特定のタスクを実行するように分割します。

関数宣言コンパイラーに関数の名前、戻り値の型、パラメーターを伝えます。関数定義関数の実際の本体を提供します。

R言語では、関数はオブジェクトであり、属性を持つことができます。

関数の定義

関数の定義は通常、以下のいくつかの部分で構成されます:

  • 関数名:関数を呼び出すときに使用できるように、関数に一意の名前を指定します。
  • パラメータ:関数が受け取る入力値を定義します。パラメータはオプションであり、複数持つことができます。
  • 関数本体:実際に実行されるコードブロックを含み、中括弧で{}囲みます。
  • 戻り値:関数の出力結果を指定します。キーワードを使用しますreturn。

R言語での関数定義はfunctionキーワードを使用します。一般的な形式は次のとおりです:

function_name <- function(arg_1, arg_2, ...) {
    # 函数体
    # 执行的代码块
    return(output)
}

説明:

  • function_name : 関数名です
  • arg_1, arg_2, ... : 仮引数リストです

関数の戻り値はreturn()。

次は、関数を定義して使用する方法を示す簡単な例です:

例

# 加算関数を定義する
add_numbers <- function(x, y) {
  result <- x + y
  return(result)
}

# 関数を呼び出す
sum_result <- add_numbers(3, 4)
print(sum_result)  # 7 を出力

上記のコードでは、次の名前の関数を定義しましたadd_numbersこの関数は2つのパラメータを受け取りますxとy。関数本体のコードはこれら2つのパラメータを加算し、結果を変数にresult格納します。最後に、returnキーワードを使用して結果を返します。

関数を呼び出すには、関数名の後にパラメータリストを続ける形式で、パラメータの値を関数に渡します。この例では、次の関数を呼び出します:add_numbers関数にパラメータ 3 と 4 を渡します。関数の実行後、結果 7 が返され、それを変数にsum_result格納し、出力します。

カスタム関数

独自の関数を作成して特定の機能に使用できます。定義後は組み込み関数と同じように使用できます。

次に、カスタム関数を定義する方法を示します:

例

# シーケンスの二乗値を計算する関数を定義する
new.function <- function(a) {
   for(i in 1:a) {
      b <- i^2
      print(b)
   }
}

次に、関数を呼び出すことができます:

例

new.function <- function(a) {
    for(i in 1:a) {
       b <- i^2
       print(b)
    }
 }
 
# 関数を呼び出し、パラメータを渡す
new.function(6)

上記のコードを実行すると、出力結果は次のようになります:

[1] 1
[1] 4
[1] 9
[1] 16
[1] 25
[1] 36

パラメータを持たない関数を作成することもできます:

例

new.function <- function() {
    for(i in 1:5) {
        print(i^2)
    }
}      
 
# 関数を呼び出す、パラメータを渡す必要はない
new.function()

上記のコードを実行すると、出力結果は次のようになります:

[1] 1
[1] 4
[1] 9
[1] 16
[1] 25

パラメータ値を持つ関数

関数のパラメータは、関数作成時の順序で渡すこともできますが、順序を変えて渡す場合はパラメータ名を指定する必要があります:

例

# 関数を作成
new.function <- function(a,b,c) {
   result <- a * b + c
   print(result)
}

# パラメータ名なし
new.function(5,3,11)

# パラメータ名あり
new.function(a = 11, b = 5, c = 3)

上記のコードを実行すると、出力結果は次のようになります:

[1] 26
[1] 58

関数作成時にパラメータのデフォルト値を指定することもできます。呼び出し時にパラメータを渡さないとデフォルト値が使用されます:

例

# デフォルトパラメータを持つ関数を作成
new.function <- function(a = 3, b = 6) {
   result <- a * b
   print(result)
}

# 関数を呼び出すがパラメータを渡さない場合、デフォルトの
new.function()

# 関数を呼び出し、パラメータを渡す
new.function(9,5)

上記のコードを実行すると、出力結果は次のようになります:

[1] 18 [1] 45

遅延評価の関数

遅延評価は、システムが計算結果を必要とするまで計算を延期します。結果が不要な場合は、計算を行う必要はありません。

デフォルトでは、R 関数のパラメータ評価は遅延されます。つまり、それを評価するときにのみ呼び出されます:

例

f <- function(x) {
  10
}
f()

上記のコードを実行すると、出力結果は次のようになります:

[1] 10

上記のコードを実行してもエラーは発生しません。パラメータを渡していませんが、関数本体でパラメータ x を使用していないため、呼び出されず、エラーにもなりません。

例

new.function <- function(a, b) {
   print(a^2)
   print(a)
   print(b)  # b を使用しているが、渡されていないためエラーになる
}

# 1つのパラメータを渡す
new.function(6)

上記のコードを実行すると、出力結果は次のようになります:

[1] 36
[1] 6
Error in print(b) : 缺少参数"b",也没有缺省值
Calls: new.function -> print
停止执行

組み込み関数

R言語には便利な組み込み関数が多数用意されており、定義せずに直接使用できます。

例:seq(), mean(), max(), sum(x) および paste(...) など。

例

# 32 から 44 までのすべての数字を出力
print(seq(32,44))

# 2つの数値の平均を計算
print(mean(25:82))

# 41 から 68 までのすべての数字の合計を計算
print(sum(41:68))

上記のコードを実行すると、出力結果は次のようになります:

 [1] 32 33 34 35 36 37 38 39 40 41 42 43 44
[1] 53.5
[1] 1526

sum(): ベクトルまたは行列の合計を計算します。

例

# ベクトルの合計
x <- c(1, 2, 3, 4, 5)
total <- sum(x)
print(total)  # 15 を出力

# 行列の合計
matrix <- matrix(1:9, nrow = 3)
total <- sum(matrix)
print(total)  # 45 を出力

mean(): ベクトルまたは行列の平均値を計算します。

例

# ベクトルの平均値
x <- c(1, 2, 3, 4, 5)
avg <- mean(x)
print(avg)  # 3 を出力

# 行列の平均値
matrix <- matrix(1:9, nrow = 3)
avg <- mean(matrix)
print(avg)  # 5 を出力

paste():複数の文字列を1つの文字列に連結します。

例

x <- "Hello"
y <- "World"
result <- paste(x, y)
print(result)  # "Hello World" を出力

length():ベクトルの長さまたはオブジェクトの要素数を返します。

例

x <- c(1, 2, 3, 4, 5)
length_x <- length(x)
print(length_x)  # 5 を出力

matrix <- matrix(1:9, nrow = 3)
length_matrix <- length(matrix)
print(length_matrix)  # 9 を出力

str():オブジェクトの構造と内容の要約を表示します。

例

x <- c(1, 2, 3, 4, 5)
str(x)
# 出力:
# num [1:5] 1 2 3 4 5

matrix <- matrix(1:9, nrow = 3)
str(matrix)
# 出力:
#  int [1:3, 1:3] 1 2 3 4 5 6 7 8 9

上記は R 言語の関数のほんの一部の例です。R には多数の組み込み関数や拡張パッケージが提供する関数があり、さまざまなデータ処理、統計分析、プロットなどのニーズを満たすことができます。R 言語の公式ドキュメントを参照して、より詳細な関数リストと使用説明を確認できます。

その他の拡張