c string

c-string

Cで文字列関数とユーティリティを提供するライブラリを使用する前に、 cd c-string/ && ./setup.shを実行してライブラリをインストールします。

例

 #include <c-string/lib.h>
#include <stdio.h>
#include <assert.h>
#include <string.h>

int main ( void ) {
  String str = String_from ( "Hello, world!" );
  printf ( "%sn" , str ); // Works, since it is NULL terminated.
  String_append ( & str , "nfoo bar" );
  printf ( "%sn" , str );
  String str2 = String_clone ( str );
  assert ( String_equal ( str , str2 )); // Identical
  String_append ( & str2 , "nbaz" );
  assert (! String_equal ( str , str2 )); // Different, since one of them changed.
  String str3 = String_slice ( str2 , 0 , 5 );
  assert (! strcmp ( str3 , "Hello" )); // You can use strcmp because it is NULL terminated.
  // Always be sure to cleanup(aka. free) the strings to prevent memory leaks.
  String_cleanup ( str );
  String_cleanup ( str2 );
  String_cleanup ( str3 );
}

種類

stringbuffer

char *のtypedef。文字のベクトルを表すために使用されます。主に文字列の基礎となるバッファーを表すために使用されますが、JavaのStringBuffer 、 std::stringstream 、またはAssemblyscriptのStringSinkのように使用することもできます。 Cベクトルで作られています。

弦

char const *のtypedef。文字列を表すために使用されます。 C StandRDライブラリと互換性があることはNULLです。

vector_string

文字列のベクトル、Just CVECTOR(String) 、C-Vectorを備えたMAFE。 String_splitおよびString_split_by_charによって使用されます。

固定ストリング

不変の固定サイズの文字列を記述する構造体。

フィールド

• int len ：長さ。
• char const *str ：ポインターコンテンツ。

関数

以下で宣言された関数とともに、Cvector_with_nameマクロから生成されるstringbufferで動作する他の関数があります。

stringbuffer_from_strlit

ヒープを割り当てることなく文字通りの文字列から文字列バッファを作成します。これは、作成されたスコープ内でのみ有効です。

• 議論：
  • char const * ：ac stringリテラル。
• return（stringbuffer）

stringbuffer_push_push_bytes

バッファーに1つずつ多くのバイトを押します。

• 議論：
  • StringBuffer *sb ：バイトがプッシュされるバッファー。
  • char *bytes ：プッシュされるバイトへのポインター。
  • int n ：BRプッシュされるバイト数。
• return（ CVECTOR_STATUS ）：c-vectorのサイレントモードを読み取ります。

stringbuffer_push_str

NULL終端文字列をバッファーに押し込みます。

• 議論：
  • StringBuffer *sb ：文字列が押されるバッファー。
  • char *str ：押しられる文字列。
• return（ CVECTOR_STATUS ）：c-vectorのサイレントモードを読み取ります。

string_new

新しい空の文字列を作成します。

• 引数：なし
• return（ String ）：新しく作成された空の文字列。

string_from_strlit

ヒープを割り当てることなく文字通りの文字列から文字列を作成します。これは、作成されたスコープ内でのみ有効です。

• 議論：
  • char const * ：ac stringリテラル。
• return（文字列）

string_from_bytes

バイトの塊から新しい文字列を作成します。

• 議論：
  • char *bytes ：コンテンツとして使用されるバイトへのポインター。
  • int n ：使用するバイト数。
• return（ String ）：コンテンツとしてバイトの場合、チャンクの新しい文字列。

string_from

プレーンNULL終端文字列から新しい文字列を作成します。

• 議論：
  • char *str ： NULL終端文字列。
• return（ String ）： NULLコンテンツとして終了した文字列を備えた新しい文字列。

string_len

• 議論：
  • String str ：文字列。
• return（ int ）：文字列の長さ。

string_clone

文字列をクローンします。 strdup NULL終端文字列を複製する方法のように機能します。

• 議論：
  • String str ：クローン化される文字列。
• return（ String ）：新しい同一の文字列。

string_concat

2つの文字列の内容を1つに連結します。

• 議論：
  • String str1 ：最初の文字列。
  • String str2 ：2番目の文字列。
• return（ String ）：連結コンテンツを持つ新しい文字列。

string_slice

文字列のセグメントをスライスします。負の後方インデックスが許可されます（つまり、インデックス-1は最後の項目を指します）。

• 議論：
  • String str ：セグメントがスライスされる文字列。
  • int fi ：開始インデックス。
  • int li ：終了インデックス。
• return（ String ）：スライスしたセグメント。 fiがliまたはfi / li 0も小さい場合、詩的なインデックスに翻訳された後、または弦の長さよりも大きいまたは等しい場合でも、 NULLが返されます。

string_hash

Murmurhash-2非暗号化ハッシュ関数を使用して文字列をハッシュします。

• 議論：
  • String str ：ハッシュされる文字列。
• return（ uint32_t ）： strのハッシュ。

string_append

最後にプレーンNULL終端文字列を追加します。

• 議論：
  • String *str ：文字列変数へのポインター。おそらく、文字列をより大きなメモリの位置に再割り当てするので、変数も再割り当てする必要があります。
  • char *bstr ：追加されるNULL終端文字列。
• return（ CVECTOR_STATUS ）：c-vectorのサイレントモードを読み取ります。冗長モードでは、文字のいずれかをプッシュすると1故障し、それ以外の場合は1返されます。

string_equal

2つの文字列を比較します。

• 議論：
  • String str1 、
  • String str2 ：比較される文字列。
• return（ bool ）：両方の文字列が長さと内容が等しく、それ以外の場合はfalseの場合はtrue 。

string_cleanup

メモリから文字列を解放します。

• 議論：
  • String str ：解放される文字列。
• return（ void ）

string_to_fixed

文字列の固定バージョンを作成して返します

• 議論：
  • String str ：ソース。
• return（ FixedString ）：最初の引数の内容を持つ固定文字列。

string_split

文字シーケンスによって文字列を分割します。

• 議論：
  • String str ：分割される文字列。
  • char const *seq ：文字シーケンス。
• return（ Vector_String ）：分割から生じる新しい文字列。

string_split_by_char

String_splitのように、しかし、シーケンスの代わりにキャラクターによって分割されます。

• 議論：
  • String str ：分割される文字列。
  • char c ：キャラクター。
• return（ Vector_String ）：分割から生じる新しい文字列。

string_trim_start

主要なtを削除します。 、 nおよび文字列の開始からの文字。

• 議論：
  • String str ：操作される文字列。
• return（ void ）

string_trim_end

string_trim_startのように動作しますが、文字列の最後で動作します。

• 議論：
  • String str ：操作される文字列。
• return（ void ）

string_trim

文字列にstring_trim_start string_trim_endを適用します。

• 議論：
  • String str ：操作される文字列。
• return（ void ）

stringbuffer_to_string

StringBufferの現在の収集されたバイトをコンテンツとして作成して、新しい文字列を作成して返します。

• 議論：
  • StringBuffer sb ：内容を保持するStringBuffer。
• return（ String ）：新しく作成された文字列。

stringbuffer_transform_to_string

stringbufferを変更し、文字列に変換します。 StringBufferへの書き込みが完了し、そのコンテンツを含む文字列が必要な場合に役立ちますが、メモリの割り当てを防ぐ必要があります。

• 議論：
  • StringBuffer sb ：変換されるStringBuffer。
• return（ String ）：本質的にsb 。

sixtString_from

文字通りの平易な静的文字列から固定ストリングを作成します。

• 議論：
  • char *str ：文字列リテラル。
• return（ FixedString ）：新しく作成された固定ストリング。

fixtring_cleanup

free() s strフィールドがNULLでなく、構造体のすべてのフィールドをゼロにする場合。

• 議論：
  • FixedString *fstr ：操作される固定ストリング。
• return（ void ）