PDFを好きに分割したいなぁ…。と考えることがあり
今回はPowerShellとiTextSharpを使用して作ってみました。

ちなみにオンラインツールでAdobeやilovePDFでPDFカットというのがあるようですね！

コードを紹介する前に

みみねこ

itextsharpはライセンスが複雑になってきたそうで、取り扱いに注意する必要があるみたいです。
pdfsharpというのもあるみたいですね！

iTextSharpのライセンスについてはこちらを参考にしました。

みみねこ

今回は作ってみただけなのでこのままコードを紹介します！

フォルダ構成

フォルダ構成はこちらです。

注意点：事前にnewフォルダに同じPDFファイルがある場合は上書きされます。

■どこかのフォルダ
┣■new　… 無くても処理中に生成されます
┣・itextsharp.dll
┣・pdf_split.ps1
┗・分割したいPDFファイル

iTextSharpの準備

こちらのページからバージョンを選択します。
ページ下部の「+ Show more」をクリックするとさらにバージョンが出てきます。

NuGet Gallery | Package Downloads for iTextSharp

www.nuget.org

「Download package」からインストールしてください。

ファイルが「itextsharp.???.nupkg」でダウンロードされますが、zipファイルなので解凍してください。

出来ない場合はitextsharp.???.nupkgをitextsharp.???.zipに名前を変更すると右クリックでも解凍できると思います。
※ ???はバージョンです。

「itextsharp.???\lib\itextsharp.dll」ファイルを使用するので、
powershellのファイルが置いてある場所にコピーしてください。

■どこかのフォルダ
┣■new　… 無くても処理中に生成されます
┣・itextsharp.dll
┣・pdf_split.ps1
┗・分割したいPDFファイル

■：フォルダ
・：ファイル

コード

以下がpdf_split.ps1のコードになります。
解説はコメントに記載しました。

※ $argsというのは引数が入った配列で$args[0]は第1引数になります。
この後実行する際に出てきます。

# 現在のディレクトリを取得
$currentDir = Get-Location
Set-Location $currentDir

# itextsharp.dllのロード
# 絶対パスを記載してください。
[System.Reflection.Assembly]::LoadFrom("C:\？？？\itextsharp.dll");

# 分割PDFの生成先フォルダパス
if(-! (Test-Path "./new")) {
    New-Item new -ItemType Directory
}
$destFolderPath = Join-Path $currentDir "new"

# inputのPDFパスを設定し、readerを生成
$srcPath = $args[0]
$pdfReader = New-Object iTextSharp.text.pdf.PdfReader($srcPath)

# ファイル名（拡張子なし）
$fileName = [System.IO.Path]::GetFileNameWithoutExtension($srcPath)

# ページ数取得し、ページ単位でfor文を回す
$pages = $pdfReader.NumberOfPages
for($page = 1; $page -le $pages; $page++) {

    # 出力する分割PDFのファイルパスを設定
    $destPath = Join-Path $destFolderPath ($fileName + "_" + $page + ".pdf")

    # ファイル生成に必要なオブジェクトを生成
    $fileStream = New-Object System.IO.FileStream($destPath, [System.IO.FileMode]::Create)
    $document = New-Object iTextSharp.text.Document($pdfReader.GetPageSize($page))
    $pdfWriter = [iTextSharp.text.pdf.PdfWriter]::GetInstance($document, $fileStream)

    # PDFファイルをオープンし、新規ページを作成
    $document.Open()
    $document.NewPage() | Out-Null

    # ページを読み込み、先ほど作成した新規ページに読み込んだページを書き込みます。
    $readPage = $pdfWriter.GetImportedPage($pdfReader, $page)
    $pdfWriter.DirectContent.AddTemplate($readPage, 0, 0)

    # reader以外のオブジェクトをクローズ
    $document.Close()
    $fileStream.Close()
    $pdfWriter.Close()
}
# 全てのページの処理が完了後readerをクローズ
$pdfReader.Close()

実行

Windows Powershellを起動します。

実行コマンド

cdコマンドでカレントディレクトリを変更

cd ps1ファイルがあるディレクトリ

pdfファイルの絶対パスを引数にpdf_split.ps1を実行

./pdf_split.ps1 "pdfファイルの絶対パス"

これでnewフォルダに分割pdfができあがります！

フォルダ

補足

.Netがないと動かないかもしれませんので、その場合はインストールをお願いします。

投稿 【PowerShell】PDFを1ページずつ分ける方法【簡単】 は nyanblog ~にゃんぶろぐ~ に最初に表示されました。

今回はC#で使用する配列とリスト（List）のそれぞれの変換方法についてご紹介します。

配列とリストの違い

配列とリストの主な違いは要素数、データの箱の数が固定か可変かどうかです。

配列の場合は宣言時に要素数を指定するため、要素数が固定である必要があります。
また、2次元配列、3次元配列…のように多次元配列を容易に扱うことができます。

一方でリストの場合は要素数の指定がなく、
要素の追加、削除を自由にできるため、要素数を動的に変更することができます。

配列からリスト（List）への変換

配列からリストに変換する方法をご紹介します。

配列 string[] からリスト List<string> に変換するには
コンストラクタの引数に配列 string[] を渡すことで変換することができます。
※ ここでは例で型をstringで説明しています。

以下の例では1行目で配列を初期化し、2行目でリストを宣言して配列からリストに変換しています。

string[] array = {"apple", "orange", "grapes"};
List<string> list = new List<string>(array);

リスト（List）から配列への変換

リストから配列に変換する方法をご紹介します。

リスト List<string> から配列 string[] に変換するには
配列が持つメソッド ToArray() で変換することができます。
※ ここでは例で型をstringで説明しています。

以下の例では1～4行目でリストを宣言・初期化し、6行目で ToArray() メソッドを使って配列に変換しています。

List<string> list = new List<string>();
list.Add("apple");
list.Add("orange");
list.Add("grapes");

string[] array = list.ToArray();

投稿 【C#】配列からリスト（List）、リスト（List）から配列へ変換 は nyanblog ~にゃんぶろぐ~ に最初に表示されました。

こんにちは。前回は「const、readonly、static readonlyの使い方・違いについて」説明していきました。
詳しくは、こちらの記事をご覧ください。

【C#】const、readonly、static readonlyの使い方・違いについて

今回はC#の定数の定義について、ご紹介していきます。const、readonly、static readonlyについて、目にしたことはあると思います。では、それぞれの違いや使い方はご存じでしょうか。const：コンパイル時に決定する定数。readonly：読み取り専用のインスタンス。static r...

nyanblog2222.com

2020.06.15

今回は前回入りきらなかった「const」を使用する時の注意点を解説していきます。

constのバージョン管理問題

constで宣言した定数はアクセス修飾子をpublicにすべきでない。と言われています。
なぜかというと、const定数はコンパイル時点で値が決定します。
例えば、クラスライブラリのMyClassには、constの定数”MAX_COUNT”が宣言されています。

public class MyClass {
  public const int MAX_COUNT = 25;
}

Program.exeに含まれるProcessクラスでは、ライブラリを読み込んでMyClass.MAX_COUNTを使います。

public class Process {
  for(int i = 0; i < MyClass.MAX_COUNT; i++) {
    …
  }
}

仕様が変わりMAX_COUNTが30になったので、constの定数を変更しました。

public class MyClass {
  public const int MAX_COUNT = 30;
}

このとき、クラスライブラリだけコンパイルして差し替えた場合、Program.exeで使用するときはMyClass.MAX_COUNTの値はどうなるでしょうか？

…正解はMyClass.MAX_COUNTの値は25になります。

理由はProgram.exeで使用しているMyClass.MAX_COUNTの値はProgram.exeをコンパイルするときに値が決まっているからです。

これをバージョンアップするときに起こる問題として、constのバージョン管理問題やconstのバージョニング問題と言います。

列挙型の代わりに構造体のconstを使わない

構造体のconstで、列挙型のような使い方をすると、予期せぬ不具合を生み出すことがあります。

こちらは構造体での使用例です。
12行目でstatusに”5″を設定していますが、何も問題なくビルドが通ります。

しかし、開発者はStatus構造体内の定数を設定したいはずなので、statusに”5″を代入してしまうことは以降の処理で不具合を起こしかねません。

struct Status
{
    public const int INIT = 0;
    public const int FAILED = 1;
    public const int SUCCESS = 2;
    public const int FINAL = 3;
}

var status = Status.INIT;

// Statusには存在しない値を設定できる
status = 5;

続いて、列挙型での使用例です。
12行目のように列挙型での宣言後、Statusに存在しない値を設定すると、ビルドエラーになります。

enum Status
{
    INIT = 0;
    FAILED = 1;
    SUCCESS = 2;
    FINAL = 3;
}

var status = Status.INIT;

// Statusに存在しない値を設定すると、ビルドエラーになる
status = 5;

まとめ

今回は前回の定数の解説に引き続き、「const」に焦点を当てて注意点を解説していきました。

特に「バージョン管理問題」は現象が起こった際にハマりやすいところだと思いますので、頭の片隅に置いておいた方が良いと思います！

良かったら他の記事もご覧になってください。

投稿 【C#】constを使用する時の注意点 は nyanblog ~にゃんぶろぐ~ に最初に表示されました。

こんにちは。今回はC#の定数の定義について、ご紹介していきます。

const、readonly、static readonlyについて、目にしたことはあると思います。
では、それぞれの違いや使い方はご存じでしょうか。

特に今まで曖昧だった方向けに本記事をご覧になっていただければと思います。

constについて

• コンパイル時に決定する定数
• 自動的にでstatic扱い。
  生成したインスタンスから取得できない。
• 宣言時のみ初期化可能
• 文字列以外の参照型での初期化はできない。
  （生成したインスタンスは設定不可）
• 固定の値を埋め込むため、readonlyより処理速度が速い
  ただし、ファイルサイズは大きくなる
• デフォルト引数やswitchで使用可能
• publicで使用するとconstのバージョン管理問題があるため、privateでの使用を推奨

使用例

/// <summary>最大数</summary>
private const int MAX_COUNT = 5;
/// <summary>みかん</summary>
private const string MIKAN = "みかん";

// 例：for文の条件式で使用
for (int i = 1; i < MAX_COUNT; i++)
{
 // ...処理
}

// switch文の判定で使用
switch (fruits)
{
  case MIKAN:
    return 15;
    break;
  // ...処理
}

readonlyについて

• 実行時に決定する読み取り専用変数
• 宣言、コンストラクタのどちらかで初期化が可能。
  （コンストラクタ内で変更も可）
• デフォルト引数やswitchで使用不可
• 生成したインスタンスを含めあらゆる値型や参照型を設定することが可能
• constと比べ、ファイルサイズを下げることができるが、処理速度が遅い
  （どちらも僅かなのでそこまで気にする必要はないと思います。）

readonlyはコンストラクタ内で初期化、変更ができるのが大きな特徴となります。

使用例

class Program
{
    /// <summary>
    /// メイン関数
    /// </summary>
    /// <param name="args">引数</param>
    static void Main(string[] args)
    {
        Class1 class1 = new Class1("読み取り専用");

        // コンソール画面に「読み取り専用」と出力
        Console.WriteLine(class1.YOMITORI_SENYOU);
    }
}

class Class1
{
    public readonly string YOMITORI_SENYOU;

    /// <summary>
    /// コンストラクタ
    /// </summary>
    public Class1(string value)
    {
        YOMITORI_SENYOU = value;
    }
}

補足

読み取り専用のインスタンス変数という意味では、readonlyを使わず「setアクセサなし」の「getアクセサ」のみのプロパティを作成しても、良いと思います。

// 例：setは記述されていないため、読み取り専用になります。
public string Fruits
{
    get { return "みかん"; }
}

static readonlyについて

• constと異なり、バージョン管理問題が起こらない。
• 生成したインスタンスやコンパイル時に計算できない値でも設定することができます。

他はconstと同様の機能を持っています。

使用例

/// <summary>テーブル一覧</summary>
public static readonly string[] TABLE_LIST = { "table1", "table2", "table3" };

foreach (string table in TABLE_LIST)
{
    // ..処理
}

まとめ

いかがでしたでしょうか。

本記事ではconstよりもstatic readonlyがおすすめさせていただきます。
また、読み取り専用のインスタンスとして、readonlyやgetアクセサのみのプロパティで実行できます。

特にconstとstatic readonlyについては、バージョン管理問題があるため、さまざまな書籍でstatic readonlyを推奨しています。
※ 「実戦で役立つ　C#プログラミングのイディオム／定石＆パターン」etc.

必ずこの記述でないといけない。ということはありませんが、少なくとも自分やプロジェクトチームではルールを決めて実装することが大事だと思います。

本記事をご覧いただき、ありがとうございました。

投稿 【C#】const、readonly、static readonlyの使い方・違いについて は nyanblog ~にゃんぶろぐ~ に最初に表示されました。

文字列の操作でよく使うプロパティ、メソッドをまとめました。
他にもあれば、どんどん追記していきます。

文字列の長さを取得する

Lengthプロパティ

文字列の長さ（文字数）を取得するには、Lengthプロパティを使用します。

string str = "value";

// length = 5
int length = str.Length;

文字列内に指定の文字（列）が含むかどうか、判定する

Containsメソッド

文字列内に指定の文字、または文字列が含まれているか判定するためには、Containsメソッドを使用します。

string str1 = "こんにちは。";

// 引数 string型
if (str1.Contains("ちは"))
    Console.WriteLine("ちは が含まれています。");

// 引数 char型
if (str1.Contains('に'))
    Console.WriteLine("に が含まれています。");

ちは が含まれています。
に が含まれています。

ちなみに、IndexOfメソッドでも確認することができます。
文字列に含まれている文字（列）の位置を取得することができます。
含まれていない場合は”-1”が戻り値として返されるので、0以上の条件で検索をかけています。

string str1 = "こんにちは。";

// 引数 string型
if (str1.IndexOf("ちは") >= 0)
    Console.WriteLine("ちは が含まれています。");

// 引数 char型
if (str1.IndexOf('に') >= 0)
    Console.WriteLine("に が含まれています。");

ちは が含まれています。
に が含まれています。

StartsWithメソッド

先頭が指定の文字列かどうかを判定には、StartsWithメソッドを使用します。
3.の例では、第２引数にtrueを設定することで大文字・小文字を考慮せずに判定することができます。

string str = "Program Test Hello";

if (str.StartsWith("Prog"))
    Console.WriteLine("1.先頭文字列が一致します。");

if (str.StartsWith("PROG"))
    Console.WriteLine("2.先頭文字列が一致します。");

if (str.StartsWith("PROG", true, CultureInfo.CurrentCulture))
    Console.WriteLine("3.先頭文字列が一致します。");

1.後頭文字列が一致します。
3.後頭文字列が一致します。

EndWithメソッド

先頭が指定の文字列かどうかを判定には、EndWithメソッドを使用します。
3.の例では、StartWithメソッドと同様に大文字・小文字を考慮することなく、判定することができます。

string str = "Program Test Hello";

if (str.EndsWith("Hello"))
    Console.WriteLine("1.後頭文字列が一致します。");

if (str.EndsWith("HELLO"))
    Console.WriteLine("2.後頭文字列が一致します。");

if (str.EndsWith("HELLO", true, CultureInfo.CurrentCulture))
    Console.WriteLine("3.後頭文字列が一致します。");

1.後頭文字列が一致します。
3.後頭文字列が一致します。

文字列がnullか空文字か判定する

IsNullOrEmptyメソッド

文字列がnull、もしくは空文字かを調べるにはStringクラスのIsNullOrEmptyメソッドを使用します。

if (string.IsNullOrEmpty(str))
    Console.WriteLine("null もしくは 空文字です。");

Emptyプロパティ

文字列がnullでないことが確実であれば、Emptyメソッドで空文字かどうかを判定することもできます。また、Emptyメソッドの代わりに””で判定しても問題ありません。

if (str == string.Empty)
    Console.WriteLine("空文字です。");

// ""でもOK
if (str == "")
    Console.WriteLine("空文字です。");

IsNullOrWhiteSpaceメソッド【.Net Framework4.0以降】

.Net Framework 4.0以上の場合、IsNullOrEmptyメソッドで空白のみの文字列も判定することができます。

// null、""、" "（半角スペース）、 "　"（全角スペース）がtrueで返される
if (string.IsNullOrEmpty(str))
    Console.WriteLine("null もしくは 空文字 もしくは 空白の文字列です。");

文字列の一部を取り出す方法

SubStringメソッド

文字列に含まれている一部分を取り出すにはSubStringメソッドを使用します。
第1引数：取り出し開始位置
第2引数：取り出し文字数（省略で開始位置から最後まで取得）

string str = "Program Test Hello";

// 0バイト目から7文字分取り出す
Console.WriteLine(str.Substring(0, 7));

// 8バイト目から4文字分取り出す
Console.WriteLine(str.Substring(8, 4));

// 13バイト目から最後まで取り出す
Console.WriteLine(str.Substring(13));

Program
Test
Hello

文字の位置といえば、IndexOfメソッドですね！
このように使うこともできます。

string str = "Program Test Hello";
string getStr = "Test";
int index = str.IndexOf(getStr);

Console.WriteLine(str.Substring(index, getStr.Length));

処理内容の説明です。
1行目：処理する文字列
2行目：取得する文字列
3行目：”Program Test Hello”から、”Test”の位置を取得し、index変数に格納
5行目：Substringメソッドでindex変数の位置からgetStrのLength分を取り出し、コンソールに出力

まとめ

stringクラスのプロパティやメソッドについて、ご紹介いたしました。
文字列操作の手段としてさまざまありますので、ぜひ参考にしてみてください。

投稿 【C#】Stringクラスで知っておくべきプロパティ・メソッド一覧 は nyanblog ~にゃんぶろぐ~ に最初に表示されました。

C#で文字列の比較方法は主に== 演算子、Equalメソッド、Compareメソッドがあります。それぞれ使用用途が異なりますので、用途に応じて使い分けていきましょう。

== （等値）演算子の使用

2つの文字列の内容が等しいかどうかを調べるには、== （等値）演算子を使用します。
以下のようにオブジェクトが異なっていても、中身が同じであれば同一と判断します。

// 変数の設定
string str1 = "sample";
string str2 = "sample";

// 文字列の比較
if (str1 == str2)
{
    Console.WriteLine("文字列は同じです。");
}
else
{
    Console.WriteLine("文字列は異なります。");
}

文字列は同じです。

また、文字列の小文字・大文字や全角・半角の区別はされますので、以下の場合、文字列は異なります。

// 変数の設定
string str1 = "Sample";
string str2 = "sample";

// 文字列の比較
if (str1 == str2)
{
    Console.WriteLine("文字列は同じです。");
}
else
{
    Console.WriteLine("文字列は異なります。");
}

■実行結果

文字列は異なります。

Equalメソッドの使用

メソッドの使用用途

等値演算子と同様に値の比較を行うメソッドがEqualメソッドです。
以下のように使用します。

// 変数の設定
string str1 = "sample";
string str2 = "sample";

// 文字列の比較
if (str1.Equals(str2))
    Console.WriteLine("文字列は同じです。");

■実行結果

文字列は同じです。

== (等値)演算子との違い

等値演算子と同じように値の比較を行いますが、両者の違いはポリモーフィズム（多様性）です。等値演算子はオーバーロードされますが、Equalメソッドはオーバーライドされることで、比較結果が異なる場合があります。
以下の例を見てみましょう。

// 変数の設定
string str1 = new string(new char[] { 's', 'a', 'm', 'p', 'l', 'e' });
string str2 = new string(new char[] { 's', 'a', 'm', 'p', 'l', 'e' });

// 文字列の比較
Console.WriteLine("== 演算子での比較");
if (((object)str1) == ((object)str2))
{
    Console.WriteLine("文字列は同じです。");
}
else
{
    Console.WriteLine("文字列は異なります。");
}
Console.WriteLine("");

Console.WriteLine("Equalsメソッドでの比較");
if (((object)str1).Equals(((object)str2)))
{
    Console.WriteLine("文字列は同じです。");
}
else
{
    Console.WriteLine("文字列は異なります。");
}

■実行結果

== 演算子での比較
文字列は異なります。

Equalsメソッドでの比較
文字列は同じです。

この例では、stringで宣言した変数に対し、object型にアップキャストして比較しています。
== 演算子ではオーバーロードのため、object型同士の比較を行っており、falseで返します。
一方Equalメソッドでは、string型でオーバーライドされたメソッドを使用しているため、trueを返します。
string型で文字列を扱っている場合には問題ありませんが、違いは知っていてもいいですね。

StringComparison列挙体の指定

Equalメソッドでは、StringComparison列挙体の値より、大文字・小文字や並べ替えの規則を指定して比較することができます。

string.Compareメソッドの使用

最後にstring.Compareメソッドで文字列の比較を行います。
Compareメソッドでは、文字列の値を比較するのではなく、文字列の並び順を比較しています。以下のように使います。

// 変数の設定
string str1 = "sample";
string str2 = "sample";

// 文字列の比較
if (string.Compare(str1, str2) == 0)
    Console.WriteLine("文字列は同じです。");

■実行結果

文字列は同じです。

この例では、戻り値を0で返しています。
Compareメソッドは並び順を比較した結果を-1、0、1で返します。内容は以下の通りです。

string.Compare(A,B);
・AがBよりも順番が前：-1
・AがBの値が同じ：0
・AがBよりも順番が後：1

ちなみにstring.CompareメソッドとString.Compareメソッドがありますが、stringはStringのエイリアスなので、どちらを使用しても大丈夫です。

大文字・小文字を区別しない方法

第3引数にtrueを入れることで大文字と小文字の区別がなく比較することができます。
以下の例で比較結果が同じであることを確認しましょう。

// 変数の設定
string str1 = "sample";
string str2 = "SamPle";

// 文字列の比較
if (string.Compare(str1, str2, true) == 0)
    Console.WriteLine("文字列は同じです。");

■実行結果

文字列は同じです。

また、.Net Framework4.0以上を使用すると、trueを名前付き引数で指定することができます。

if (string.Compare(str1, str2, ignoreCase:true) == 0)

このように指定すると、引数の意味が分かりやすく可読性があがりますね。

全角・半角を区別しない方法

全角・半角を区別しない場合は、CultureInfoとCompareOptions.IgnoreWidthを引数に設定します。
以降の例ではSystem.Globalizationの名前空間を宣言しています。

// 変数の設定
string str1 = "sample";
string str2 = "ｓａｍｐｌｅ";
var cultureInfo = new CultureInfo("ja-JP");

// 文字列の比較
if (string.Compare(str1, str2, cultureInfo, CompareOptions.IgnoreWidth) == 0)
    Console.WriteLine("文字列は同じです。");

■実行結果

文字列は同じです。

全角・半角、大文字・小文字を区別しない方法（複数オプション指定）

全角・半角、大文字・小文字を区別しない場合は、CompareOptions.IgnoreWidthとCompareOptions.IgnoreCaseをOR演算子で繋げることで複数の値を設定することができます。

// 変数の設定
string str1 = "sample";
string str2 = "ＳＡＭＰＬＥ";
var cultureInfo = new CultureInfo("ja-JP");

// 文字列の比較
if (string.Compare(str1, str2, cultureInfo,
  CompareOptions.IgnoreWidth | CompareOptions.IgnoreCase) == 0)
    Console.WriteLine("文字列は同じです。");

■実行結果

文字列は同じです。

ちなみにCompareOptions.OrdinalIgnoreCaseも大文字・小文字を区別しませんが、上記のように複数値の設定では使用できませんでした。

他にもひらがなとカタカナを区別しないCompareOptions.IgnoreKanaTypeも存在しますので、以下を参考にしてみてください。
参考：CompareOptions 列挙型

まとめ

今回はC#で文字列の比較方法について、ご紹介いたしました。
文字列の値の比較は==（等値）演算子、Equalメソッドを、並び順はstring.Compareメソッドを使って、試してみてください。

投稿 【C#】文字列を比較する（== 演算子、Equalメソッド、Compareメソッド） は nyanblog ~にゃんぶろぐ~ に最初に表示されました。