Add examples in README

1 files changed, 56 insertions, 0 deletions

diff --git a/README.md b/README.md
index f8105c2..619af56 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,62 @@
 
 cpuinfo is a library to detect essential for performance optimization information about host CPU.
 
+## Examples
+
+Detect if target is a 32-bit or 64-bit ARM system:
+
+```c
+#if CPUINFO_ARCH_ARM || CPUINFO_ARCH_ARM64
+    /* 32-bit ARM-specific code here */
+#endif
+```
+
+Check if the host CPU support ARM NEON
+```c
+cpuinfo_initialize();
+#if CPUINFO_ARCH_ARM
+    if (cpuinfo_isa.neon) {
+        neon_implementation(arguments);
+    }
+#endif
+```
+
+Check if the host CPU supports x86 AVX
+```c
+cpuinfo_initialize();
+#if CPUINFO_ARCH_X86 || CPUINFO_ARCH_X86_64
+    if (cpuinfo_isa.avx) {
+        avx_implementation(arguments);
+    }
+#endif
+```
+
+Check if the thread runs on a Cortex-A53 core
+```c
+cpuinfo_initialize();
+if (cpuinfo_current_core()->uarch == cpuinfo_uarch_cortex_a53) {
+    cortex_a53_implementation(arguments);
+}
+```
+
+Get the size of level 1 data cache on the fastest core in the processor (e.g. big core in big.LITTLE ARM systems):
+```c
+cpuinfo_initialize();
+const size_t l1_size = cpuinfo_processors[0].l1d->size;
+```
+
+Pin thread to cores sharing L2 cache with the current core (Linux or Android)
+```c
+cpuinfo_initialize();
+cpu_set_t cpu_set;
+CPU_ZERO(&cpu_set);
+const struct cpuinfo_cache* current_l2 = cpuinfo_current_processor()->l2;
+for (uint32_t i = 0; i < current_l2->processor_count; i++) {
+    CPU_SET(cpuinfo_processors[current_l2->processor_start + i].linux_id, &cpu_set);
+}
+pthread_setaffinity_np(pthread_self(), sizeof(cpu_set_t), &cpu_set);
+```
+
 ## Exposed information
 - [x] Processor (SoC) name
   - [x] Integrated GPU name (Android only)